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NOTE FROM THE EDITOR 


This important technical book — including preface, dated back to 1985, had been 
reworked and modified appropriately in order to give more detailed explanation of how 
V9938 chip works and how to effectively program the system based on it. 


While MSX gave up to the IBM PC standard as a computing platform in early 1990s, it 
is still one of the powerful specimens in the field of 8-bit home entertainment and hobbyist 
platforms. It is argued that modern PC architecture origins at the MSX standard; and it is 
clear that initiative, taken by Microsoft and ASCII by institutionalizing software and 
hardware compatibility was taken in further developments on the IT market. 


V9938 is one of the most popular video-processors in the family of Texas Instruments 
original chips, improved by a group of companies from Japan and US. Its follower, V9958, 
was a VDP chip for limited release of MSX2+ and MSX Turbo-R machines, and the last VDP 
in the family, V9990, can only be found in add-on cartridges. 


The book is provided in PDF format and is searchable to allow internet search engines 
indexing it so that potential readers would easily find it. 


December, 2010 
Eugeny Brychkov 


Rev. 1.00 (Jan 06, 2011): Initial release 

Rev. 1.01 (Jan 27, 2011): corrections per Daemos et al. 
Rev. 1.01a (Mar 06, 2011): corrections per ARTRAG et al. 
Rev. 1.01b (June 02, 2015): corrections per yzi and ARTRAG 


Please log issues with this document to the following MSX Resource Center thread: 
http://www.msx.org/forumtopici2176.html 
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PREFACE 


The V9938 introduced in this manual is a Very Large-Scale Integrated Circuit (VLSI) 
that was developed as a video Display Processor (VDP) for the MSX2. The MSX personal 
computer standard was introduced in 1983 by ASCII Corporation and Microsoft 
Incorporated. At present, the MSX is manufactured and marketed worldwide. In order to 
strengthen some of the functions of the original MSX, the MSX2 standard was developed in 
1985. In addition to being software-compatible with the MSX, the MSX2 supports new 
media and has video processing capabilities that are not available on conventional 8-bit 
personal computers. 


To make the MSX2 a reality, two requirements for the Video Processor were: upward 
compatibility with the existing TMS9918A (the VDP for the MSX) software and increased 
number of functions. The V9938 was developed through the joint efforts of ASCII 
Corporation, Microsoft Incorporated, and YAMAHA. 


The following functions are supported on the V9938: 

= Full bit-mapped mode 

= 80-column text display 

= Access using X- and Y-coordinates for easier programming; the X-Y coordinates 
are independent of the screen mode 

= Fundamental hardware commands to decrease the processing time and reduce 
programming complexity 

= Digitize and external synchronization 

= Color palette (9 bits x 16 patterns) 

= Linear RGB video output 

= More sprites per horizontal line 


Because the V9938 has the above functions, it provides superior video capabilities 
that make it possible for its use in a variety of applications, including the MSX2. CAPTAIN 
terminals and NAPLPS terminals using the V9938 have already been developed. We hope 
that the V9938 will be a standard video processing device on a worldwide basis. 


This manual was written to explain how to set parameters of the v9938 and is a 
reference for developing applications and system software for it. 


We are pleased that you have chosen to develop software for the V9938 and that you 
have referred to this manual for assistance. 


Finally, we would like to express our deep gratitude to the people at NTT as well as 
other related manufacturers for their valuable opinions which contributed to the 
development of the V9938. 


August, 1985 
ASCII Corporation 


© 1985 ASCII CORP. / NIPPON GAKKI CO. Page 5 of 108 © 2010-2015 Eugeny Brychkov 


This page is intentionally left blank 


© 1985 ASCII CORP. / NIPPON GAKKI CO. Page 6 of 108 © 2010-2015 Eugeny Brychkov 


CONTENTS 


DEFINI TLONS siisssisasssctasssscsscancsieeccnassnnsssaasiscssassnsssusssnscsseansiansdaaaaniesdnanannsien 9 
1: BASIC INPUT AND QUTPUTȚ wisiscsiesiisiscnsnssaseraaiiccsinstaviueeasinaimemiaasaniondiauen 13 
1.1. Accessing the Control Registers .......s..ssssssssssssssrsssrnsrrnrrrnrrnnnrnnrrnrrnsrrsrrennne 13 
1:1:1; Direct access to VDP registers minien eoa 13 

1.1.2. Indirect access to registers through R#17 (Control Register Pointer) ..13 

1.2. Accessing the Palette ReGiSters...........:c:ccccscesseecsseeccseseseeseesseeesseeseseseaes 14 
1.3. Accessing the Status RegisterS............ss.sserssssresseserssnensnnennnnerennoneeneresnenanne 14 
1:4. Accessing the Video RAM 2. ccossiccasiativadechiosyuicecannedieceedeniedsiandaniccexdindabedete 14 
2. REGI STER FUNCTIONS wiiisssssstactsssansssssssssecsanacstassannssctesssasaesannnnsecdanensinans 17 
2:1; Control register S siosnrinannre e a 17 
2:11 Mode PECISIENS  usicaiwasinusnacaasuncapenidyonneudeiabienwepiiawraseeraiaadens aa 17 

2.1.2. Table Base address reGiSters.............cccssccssscseseeseesesseeeseersesesseneseeeenes 18 

2:1:3: Color registers soririionn ve re a En Sone een rar 19 

2:14 Display registo po eee ee rene ee eee ee te ee eereery a me mer eee 20 

2: La se rEJISTETS asec ee ens 2i 

2:1:6; Command registers x sascencnceneastece sews inanar dE da RA 22 

2:2 Status registers #0. WF oo nmiandiniodinamnlaneien E N 23 
3: SCREEN MODES iticsisnctidcissnentsaieratainivinmiuaiieccabeiiiuieeiinbeaniiinsienadieadineadicdin 25 
3-1; TEXTIL MOd Erorien OAA 25 
3.2. TEX T2 MOdE inasema EA 29 
3-3- MULTICOLOR (MC) MOd 6 x ccsiccinasinisnecaees pegeaniarncraeianiameaaeeatea ree 34 
34; GRAPHIC | (GL) MOUS rinena R 38 
3.5. GRAPHIC2 (G2) and GRAPHICS (G3) modes <...ccsccccscccsssessessscesccccseereesence! 42 
36; GRAPHIC: (G4) MOTE ikesi ace cere crete esate esate e EaR 47 
Sd GRAPHICS: (G5) MOE mennase 50 
3:8; GRAPHICO (G6) MOQ vecasconseseaccaantacieniacnasacmesantensaeneisesesaeseaaapedeneasatanians: 55 
29 GRAPHIC (G7 MOE iosian eee eens era een iten emer sere n eeemrey 59 
4: COMMANDS ss vntititaciccecavicddussanrianrniniiieimiincacedsiideaiuusdiaieeeininalaeaeniensisaisdnian 63 
AAs TYPES Of COMING ooo hecdaenectsducdereatexdaduonctteasidentaet)ddndadenuduencdedeatuuincdacad! 63 
4-2 Page CONCEDE arnesa a a R 64 

4 3: Logical DET EATS srania a a Ea 65 
4.4. Explanations of CommandS.........sssssssssssssssssssnsrrsrrnnnnrnnnnnnnnnnnnnnenrennnsnnnnnns 66 
4.4.1. HMMC (High-speed move CPU to VRAM)..........::ccssseesseeeeseeeseerenseseaes 66 

4.4.2. YMMM (High speed move VRAM to VRAM, y only) ......eceeeeeeseeeeseeeenees 69 

4.4.3. HMMM (High speed move VRAM to VRAM)......::ccccseecsseecseeecssesneeseaes 7i 

4.4.4. HMMV (High-speed move VDP to VRAM).......ccsssecsseeesseeeeeeeeaeeesaeeenaes 73 

4.4.5. LMMC (Logical move CPU to VRAM).........::csssecsesscseescsseecneecssecneessees 75 

4.4.6. LMCM (Logical move VRAM to CPU)..........ccssccsseeessseesseecsseecsseseeensaes 78 


© 1985 ASCII CORP. / NIPPON GAKKI CO. Page 7 of 108 © 2010-2015 Eugeny Brychkov 


4.4.7. LMMM (Logical move VRAM to VRAM).........:::ccsscesseeesseeesseeesseseeeeseaes 81 


4.4.8. LMMV (logical move VDP to VRAM) scesesiccdocacassceececsadecincdoaseevacccasncees 83 

449. LINE crore E a EE 85 

4-4 10: SROM ccrann E EE 87 

44 al PSE Trasie aa 90 

44.12: POINT cedars aacanetaceccissceceeeececendasanessecisacecuectsseneicanveinceieeeteeraeciedeseeesace: 92 

4.5. Speeding up the processing Of commandS ..........s.sssssrssrrrrrsrnrrnrrnrnnnenrennena 93 

4.6. States of the registers after command execution .........ssssssssrsrrnrrrrrsrenrerenna 94 

5. SPRITES scsssssaccicasnsrsnccdcsensndansnreasisssanniseansnsisasadaanstanansawsseasaunnsenaneramnsiaanes 95 

5:1 Sprite mode FG 2. MG) act saceninccuscdcnmondcacaacnciacntiastesancansassenataiatuaeee 96 
5.2. Sprite mode 2 (G3, G4, G5, G6, G7) ee ennerene a Wenmener ern ner ttre rere te eer 100 
5.3. Special rules for sprite color settings .........s.ssssssssssssnseressrnersnnensnnensnannennene 107 
6: SPECIAL FUNCTIONS iissssinescssecsassoiscsasaascesscctassisnsnncescassassusannstenssesensnnaes 108 
6.1. Alternate display of two graphics screen pages .......csseeeeseeeeseeesaeeenseeenaeeees 108 
6.2. Displaying two graphics screens at 6OHZ.........:ccecesseeeseeeeeeeeeeeeeseeeenaeeena eee 108 
ome Mallia) cle (518 << SPAY gaa enema nr ne ests anE ene ment Ey er Sal Sha eRe eee pce enon mar ee meen Oe eye 108 


© 1985 ASCII CORP. / NIPPON GAKKI CO. Page 8 of 108 © 2010-2015 Eugeny Brychkov 


DEFINITIONS 
A 


Attribute 
The property of an object, which controls how object looks like on the screen. Attribute 
can be a color, position of an object, or control which pixel should have specific color 


Background 

Is an object or property which is perceived to be in the background to another property or 
object. For example, for a character displayed on the screen the pixels of its image is said 
to have foreground color, while other pixels to have background color. In case of sprites, 
they may be said to appear in the foreground to the font patterns, as sprites overlap 
images of the font. See also Foreground 


C 


Collision 

Sprites are said to collide when their dots having color code 1 (simply saying — dots 
identified with binary 1s in their sprite pattern generator table) overlap. In some 
circumstances such behavior may be changed in favor or mixing sprite colors to have 
pseudo-multi-colored sprites 


Color 

A property of the pixel on the screen. Color of the pixel may come from various sources: 
from global color register, from pattern color table or from sprite color table. Colors can 
also be coded in the palette registers through setup of red, green and blue components — 
in this case, if color table of the patterns and sprites remain unchanged, actual colors, 
associated with them, may be different 


Command 

A special sequence of VDP operations, a kind of hardware acceleration. Command is 
expected to streamline CPU-VDP-VRAM operations, unload CPU and increase data transfer 
speed. 


Expansion RAM 

This random access memory is used to store non-displayed data or register information, 
and is not necessary for proper operation of the VDP. Maximal size or expansion RAM is 
64K bytes. Due to specific purposes of this RAM, it is rarely used in applications. 
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L 


Layout 

A map of patterns or sprites which identify where to display specific object or which object 
should be displayed in specific position. In case of patterns (font), Pattern generator Table 
identifies the appearance of font, but in order to display these patterns in specific position, 
programmer should put its number into Pattern Layout Table in respective location 


O 


Object 
Font patterns or a sprite. 


P 


Pattern 

A property of an object identifying how object looks like. Object can be a font pattern or a 
sprite pattern. Pattern may be represented by one byte or 8 bytes in different modes; its 
contents codes colors of the pixels displayed. For some modes, 8 bits (one byte) can code 
8 pixels — 0 for background color and 1 for foreground color, in other modes 8 bits can 
code 4 pixels — with colors 0, 1, 2, and 3. To display font patterns on the screen it may not 
be enough to set its pattern, but also put its pattern number into the /ayout map. VDP, 
when displaying the picture, reads the number of pattern to display, and then refers to its 
actual image to font pattern generator table 


Port 

Is a physical latch with specific system address for CPU reads and writes to communicate 
with VDP. VDP has four ports, port #0 is a read/write data port, port #1 is write register 
set-up port, port #2 is write palette port, and port #3 is write register data port 


R 


Register 

Register is a static place within VDP for control information about VDP’s mode, screen 
property etc. Registers can be Status, Video or Command. They can be accessed directly 
or indirectly. Access to the registers is made through consecutive writes to specific VDP 
ports, thus in order not to break the order and thus successful completion of specific 
operation, programmer should disable interrupts. 


RGB 

Abbreviation for base colors Red, Green and Blue. It may be used to describe hardware 
wiring with three analog signals; or to describe a color composition for the pixel. Note that 
when coding RGB in VDP palette registers programmer uses 3 bits for every base color, 
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and when coding RGB in GRAPHIC 7 mode red and green occupy 3 bits each, but blue 
occupies only 2 bits 


T 


Tile 
Same as font pattern 


V 


VRAM 

Video Random Access Memory is a set of memory cells used by VDP to keep information 
about picture displayed on the screen. VRAM is accessed for picture displaying purposes as 
well as for picture modifications. Picture displaying occurs continuously when VDP is 
enabled. V9938 may have 16K to 128K VRAM, and depending on the memory organization 
and size may not be able to function properly in specific modes. See description of register 
R#8's bit VR for more information 
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1. BASIC INPUT AND OUTPUT 


1.1. Accessing the Control Registers 


V9938 has 4 ports: port #0 — port #3; port number is selected by VDP address lines 
AO and A1. Table below also shows port address allocation for MSX compatible machine. 


Al | AO Operation Primary MSX port (Hex) 
Port #0 0 0 VRAM Data (R/W) 98h 
Port #1 0 1 Status Register (R) 99h 


VRAM Address (W) 
Register set-up (W) 
Port #2 1 0 Palette registers (W) 9Ah 
Port #3 1 1 Register indirect addressing (W) 9Bh 


There are two ways to set data in the MSX-VIDEO control registers (R#0 to R#46). 


1.1.1. Direct access to VDP registers 


Output the data and the register number in sequence to port #1. The order of reads 
and writes to/from VDP ports is vitally important, thus you should keep in mind that this 
order can be potentially interrupted by CPU interrupt routine which can write to or read 
from VDP port(s) and thus break the proper sequence. In case of Z80 CPU, use DI 
(disable interrupts) at the start and El (enable interrupts) at the end of VDP your access 
code. 

Data byte is written first (bits DO-D7), and register number is written next to data 
byte (bits RO-R5). If interrupt involving VDP operations will occur between these two 
operations, it may cause unpredictable results. 


MSB 7 6 5 4 3 2 1 0 LSB 
Port #1 first byte D7 | D6 | D5 | D4 | D3 | D2 | D1 | DO Data 


Port #1 second byte 1 | O | R5 | R4 | R3 | R2 | R1 | RO Register # 


1.1.2. Indirect access to registers through R#17 (Control Register Pointer) 


Set the register number in R#17 using direct addressing and then send data to Port 
#3. MSB of the value written to R#17 (AII) controls auto-incrementing of the register 
number. If auto-incrementing is enabled, after each data read or write control register 
pointer is incremented; if auto-incrementing is disabled then pointer value in R#17 remains 
unchanged. Auto-increment mode is useful for bulk read or update of VDP registers. 
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Note: data in register R#17 can not be changed by indirect addressing. 


MB 7 6 5 4 3 2 1 0 LSB 
Register #17 All | 0 | R5 | R4 | R3 | R2 | Ri | RO Register # 


0: Auto-increment is enabled 
1: Auto-increment is disabled 


Port #3 first byte D7 | D6 | D5 | D4 | D3 | D2 | D1 | DO Data 
Port #3 second byte D7 | D6 | D5 | D4 | D3 | D2 | D1 | DO Data 
Port #3 n™ byte D7 | D6 | D5 | D4 | D3 | D2 | D1 | DO Data 


1.2. Accessing the Palette Registers 


To set data in the MSX-VIDEO palette registers (P#0 to P#15) you must first set the 
palette register number in register R#16 (Color palette address pointer) and subsequently 
write two bytes of data (in specific order) into port #2. Every color consists of 3 sets of 3 
bits: red, green and blue component (value 0...7). 


Note: after writing pair of data to port #2 palette register number (pointer) in 
register R#16 auto-increments. 


MSB 7 6 5 4 3 2 1 0 LSB 


Register #16 0 0 0 O | C3 | C2 | C1 | CO Palette # 

Port #2 first byte 0 |R2 Ri RO} O | B2 Bi BO Data 1 
Red data Blue data 

Port #2 second byte 0;0/;0; 0; 0 |G2 Gi GO Data 2 


1.3. Accessing the status registers 


To read the status registers of MSX-VIDEO (S#0 to S#9) you must first set the 
register number in R#15 (Status register pointer) and then read data from port #1. 


MSB 7 6 5 4 3 2 1 0 L&B 


Register #15 (write) 0}; 0} 0 | 0 | S3 | S2 | S1 | SO Stat Reg # 
Port #1 data (read) D7 | D6 | D5 | D4 | D3 | D2 | Di | DO Data read 
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1.4. Accessing the Video RAM (VRAM) 


A video RAM of 128K bytes plus an expansion RAM of 64K bytes can be attached to 
the VDP. Memory map is shown below. 


Address 


1FFFFh 


i 
i 
il 
i 


10000h 


OFFFFh 


f 
T 
T 
T 


00000h 


Video RAM Expansion RAM 
(used for display) (for data I/O 
registers) 


To access memory, use the following procedure: 

1. Switch respective bank (VRAM or expansion RAM) 

2. Set the address counter A16 to A14 

3. Set the address counter A7 to AO 

4. Set the address counter A13 to A8, and specify if following data command will be 
read or write 

5. Read or write data to the memory 


Step 1: Switching banks (VRAM to expansion RAM) 

Applications are used to work with Video RAM, thus re-specification of the bank is 
rarely necessary. It will be required if your application will need to access expansion RAM. 
After performing necessary operations on expansion RAM, ensure that you map the Video 


RAM back. 


MSB 7 6 5 4 3 2 1 0 LSB 


Register #45 0 [|MXC|MXD | MXS | DIY | DIX | EQ | MAJ] Argument 
0: Video RAM register 
1: Expansion RAM (ARG) 
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Step 2: Setting the address counter A16 to A14 


VDP can logically address 128K bytes in the address range of 00000h-1FFFFh through 
16 address bits A16...A0. At this step we set up bits A16...A14 writing them into register 
R#14 (VRAM access base address register). 


MSB 7 6 5 4 3 2 1 O LSB 
Register #14 0 0 0 0 O | A16 | A15 | Al4 Base reg 


Step 3: Setting the address counter A7 to AO 
Set the low-order eight bits A7...A0 of the address counter by writing data to port #1. 


MSB 7 6 5 4 3 2 1 0 LSB 
Port #1 A7 | A6 | A5 | A4 | AB | A2 | Ai | AO A7...A0 


Step 4: Setting the address counter A13 to A8 and operation mode 


Set the remaining six bits A13...A8 of the address counter by writing data to the port 
#1. 

You also should specify which memory operation will follow — read or write. It is very 
important, as if you specify that next operation will be a “read”, VDP will pre-fetch value 
from the memory (specified by the address set up earlier) and will get ready for CPU data 
read. If you will not do so and issue read command, VDP may not get enough timeslot to 
read data from the VRAM and CPU may get invalid data. 

If you specify that next command will be a “write”, then VDP does not do pre-fetch 
and waits for write instead. 


MSB 7 6 5 4 3 2 1 0 LSB 
Port #1 0 W | A13 | A12 | All | A10 | A9 | A8 A13...A8 


0: Next command is “Data Read” 
1: Next command is “Data Write” 


Step 5: Reading or writing data to memory 


It is important to know that after every data read or data write operation from port 
#0 address counter is being incremented. It is very useful when you need to read from or 
write to the memory in sequential manner. However you should mind the timing, ensuring 
that VDP has enough time to write cached data or read requested data. Please refer to the 
data sheet for timings. 


MSB 7 6 5 4 3 2 1 0 LSB 
Port #0 D7 D6 D5 D4 D3 D2 Di DO Data 
Addr ++ 
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2. REGISTER FUNCTIONS 


2.1. Control registers #0 to #23 
#32 to #46 


2.1.1. Mode registers 


MSB 7 6 5 4 3 2 1 O LSB 
R#0 0 DG | IE2 | IEl | M5 | M4 | M3 0 Mode R#0 
R#1 0 BL | IEO | Mi | M2 0 SI | MAG Mode R#1 
R#8 MS | LP | TP | CB | VR 0 | SPD | BW Mode R#8 
R#9 LN 0 Si | SO IL EO | *NT | DC Mode R#9 


* Indicates negative logic 


R#0 | DG Digitize mode. sets the color bus to the input or output mode 
IE2 Enables interrupts from Light pen 


IE1 Enables interrupt from horizontal retrace 

M5 Screen mode flag (see Screen Modes chapter) 

M4 Screen mode flag (see Screen Modes chapter) 
N M Screen mode flag (see Screen Modes chapter) aaa 
R#1/BL Blank screen: if set to 1, screen display is enabled. If set to 0, screen l 


display is disabled and no VRAM read operations are performed. 
IEO Enables interrupt from vertical retrace 


Mi Screen mode flag (see Screen Modes chapter) 
M2 Screen mode flag (see Screen Modes chapter) 
SI Sprite size: when set to 1, sprite size is 16*16. If set to 0, sprite size is 
8*8 
_.....| MAG ____ Sprite enlarging: If set to 1, sprites are enlarged (double size) 
R#8 |MS Mouse: when set to 1, sets the color bus into input mode and enables 


mouse. If set to 1, sets color bus into output mode and disables mouse 

LP Light pen: when set to 1, enables light pen 

TP Sets the color of code 0 to the color of the palette 

CB Color bus: when set to 1, sets color bus into input mode. If set to 0, sets 
color bus into output mode 

VR Selects the type and organization of VRAM. If set to 1, VRAM is 64Kx1Bit 
or 64Kx4bits. If set to 0, VRAM is 16Kx1Bit or 16Kx4Bits. Affects how VDP 
performs refresh on DRAM chips 

SPD Sprite disable: if set to 1, sprites are not displayed and related VRAM reads 
are not performed. 
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Line: if set to 1, vertical dot count is set to 212. If set to 0, vertical dot 
count is 192 

Selects simultaneous mode 

Selects simultaneous mode 

Interlace: if set to 1, interlace; if set to 0, non-interlace mode 
Even/Odd screens: When set to 1, displays two graphic screens 
interchangeably by even/odd field; if set to 0, displays same graphic 
screen by even/odd field 

(RGB output only) If set to 1, PAL mode (313 lines, 50Hz); if set to 0, 
NTSC mode (262 lines, 60Hz) 

Dot clock: If set to 1, *DLCLK is in input mode; if set to 0, *DLCKL is in 


2.1.2. Table Base address registers 


When displaying information on the screen, VDP uses color, pattern, sprite and other 
information from video RAM. It is important to set proper starting addresses of such VRAM 
locations by writing to specified table base address registers. 


Note: you should ensure that unused bits are set to 0. Further in the book bit set to 
“0” will mean that this bit has to be set to 0, “1” will mean that this bit has to be set to 1, 


and 


R#2 


R#3 


R#10 


R#4 


R#5 


R#11 


R#6 


“x” will mean that value of the bit does not matter. 


MSB 7 6 5 4 3 2 1 0 LSB 


0 A16 | A15 | A14 | A13 | A12 | A11 | A10 Pattern layout 
table 


A13 | A12 | A11 | A10 | A9 A8 A7 A6 Color table low 


0 0 0 0 0 | A16 | A15 | A14 Color table high 


0 O | A16 | A15 | A14 | A13 | A12 | Ali Pattern 
generator table 


A14 | A13 | A12 | A11 | A10 | A9 A8 A7 Sprite attribute 
table low 


0 0 0 0 0 0 | A16 | A15 Sprite attribute 
table high 


0 O | Al6 | A15 | Al4 | A13 | A12 | All Sprite pattern 
generator table 
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2.1.3. Color registers 


Color registers are used to control MSX-VIDEO text and background screen colors, 
blinking and other functions. 


MSB 7 6 5 4 3 2 1 0 LSB 


R#7 TC3 | TC2 | TC1 | TCO | BD3 | BD2 | BD1 | BDO | Text and screen 
Text color in TEXT1 and Screen margin / margin color 
TEXT2 modes backdrop color 
MSB 7 6 5 4 3 2 1 0 LSB 
R#12 T23 | T22 | T21 | T20 | BC3 | BC2 | BC1 | BCO Text and 
Color part 1 Color part 0 background 
blink color 


In TEXT2 mode, if attributes for blinking are set, color set in this register R#12 and in 
register R#7 are displayed alternatively (blinked). 


MSB 7 6 5 4 3 2 1 0 LSB 


R#13 ON3 | ON2 | ON1 | ONO | OF3 | OF2 | OF1 | OFO Blinking period 
Display time for even Display time for odd register 
page page 


In the TEXT2 mode and in bit map modes of GRAPHIC4 to GRAPHIC7 two pages can 
be alternatively displayed (blinked). Write to this register R#13 in order for blinking to start. 


MSB 7 6 5 4 3 2 1 0 LSB 


R#20 0 0 0 0 0 0 0 0 Color burst 
register 1 

R#21 0 0 1 1 1 0 1 1 Color burst 
register 2 

R#22 0 0 0 0 0 1 0 1 Color burst 
register 3 


The above values of color burst registers are preset on power-on. If all the bits in all 
three registers are set to 0, color burst of the composite video is not performed. If values 
are returned to above values, VDP will start generating normal color burst signal. 
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2.1.4. Display registers 


The display registers are used to control display position on the screen. 


MSB 7 6 5 4 3 2 1 0O LSB 
R#18 V3 | V2 | Vi | VO | H3 | H2 | Hi | HO Display adjust 
register 


Register #18 controls horizontal and vertical alignment on the screen. Please refer to 
the table below. 


Value 
7 a 1 0 15 a 8 
H Left Center Right 
V Top Center Bottom 
MSB 7 6 5 4 3 2 1 0 LSB 
R#23 DO7 | DO6 | DOS | DO4 | DO3 | DO2 | DO1 | DOO Vertical offset 
register 


This register R#23 sets the value of the first line to display on the screen. Virtual 
screen size is 256 lines, visible vertical screen size can be 192 or 212 depending on LN bit 
of register R#9. Setting R#23 to value other than 0 may display un-initialized parts of the 
memory which may look as garbage. Display of virtual screen is performed in cycle, 


meaning that when increasing value of R#23 top of virtual screen appears at the bottom of 
visible screen. Please see pictures below. 


Original screen* in 
GRAPHIC1 mode 


Offset screen*, horizontal 
scan line is 256 dots, 
GRAPHIC1 mode, top 
appears at the bottom 


TEXT1 mode, horizontal 
scan line is 240 dots, 
garbage in un-initialized 
memory space 


* “Auf Wiedersehen Monty” image, a property of Gremlin Graphics. Used in this book for educational purposes only 
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MSB 7 6 5 4 3 2 1 0 LSB 


R#19 IL7 | IL6 | ILS | IL4 | IL3 | IL2 | IL1 | ILO Interrupt line 
register 


VDP generates interrupt when it starts to display respective scan line if bit 4 “IE1” of 
register R#0 is set to 1. Write a value to this register R#19, and when VDP will start 
displaying the specified line, it will set bit O “FH” of status register S#1 to 1. 


2.1.5. Access registers 


Access registers is the set of registers used for accessing other VDP registers or VRAM. 
These registers include R#14, R#15, R#16 and R#17. 


MSB 7 6 5 4 3 2 1 0 LSB 
R#14 0 0 0 0 O | A16 | A15 | A14 VRAM access 
base register 


R#14 contains three senior bits of VRAM access address. In all modes, except 
GRAPHIC1, GRAPHIC2, MULTICOLOR and TEXT1, if there’s a carry flag from A13 the value 
in this register is automatically incremented. 


MSB 7 6 5 4 3 2 1 0O LSB 
R#15 0 0 0 0 S3 S2 Si SO Status register 
pointer 


R#15 points to the respective status register (S#0...S#9) to be read. 


MSB 7 6 5 4 3 2 1 0 LSB 
R#16 0 0 0 0 C3 | C2 | C1 CO Color palette 
address register 


R#16 points to the respective color palette register (P#0...P#15) to be accessed. 


MSB 7 6 5 4 3 2 1 0O LSB 
R#17 AII 0 | RS5 | RS4 | RS3 | RS2 | RS1 | RSO Control register 
pointer 


R#17 is a register used in indirect access to other VDP registers. It also has auto- 
increment flag (AII) which is used to control increment of value in this register. 
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2.1.6. Command registers 


The following command registers are used when executing a command on the MSX- 
VIDEO. Details on the use of these command registers will be presented in later chapter. 


R#32 


R#33 


R#34 


R#35 


R#36 


R#37 


R#38 


R#39 


R#40 


R#41 


R#42 


R#43 


R#44 


R#45 


R#46 


MSB 


MSB 


MSB 


MSB 


7 6 5 4 3 2 1 0 
SX7_| SX6 | SX5 | SX4 | SX3 | SX2 | SXi | SXO 
0 0 0 0 0 0 0 | SX8 
SY7 | SY6 | SY5 | SY4 | SY3 | SY2 | SY1 | SYO 
0 0 0 0 0 0 | SY9 | SY8 
7 6 5 4 3 2 1 0 
DX7 | DX6 | DX5 | DX4 | DX3 | DX2 | DX1 | DXO 
0 0 0 0 0 0 0 | DX8 
DY7 | DY6 | DY5 | DY4 | DY3 | DY2 | DY1 | DYO 
0 0 0 0 0 0 | DYI | DY8 
7 6 5 4 3 2 1 0 
NX7 | NX6 | NX5 | NX4 | NX3 | NX2 | NX1 | NXO 
0 0 0 0 0 0 O | NX8 
NY7 | NY6 | NY5 | NY4 | NY3 | NY2 | NY1 | NYO 
0 0 0 0 0 O | NY9 | NY8 
7 6 5 4 3 2 1 0 
CH3 | CH2 | CH1 | CHO | CL3 | CL2 | CL1 | CLO 
O | MXC | MXD | MXS | DIY | DIX | EQ | MAJ 
CM3 | CM2 | CM1 | CMO | LO3 | LO2 | LOI | LOO 
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LSB 


Source X low 
register 


Source X high 
register 
Source Y low 
register 


Source Y high 
register 


LSB 


Destination X 
low register 


Destination X 
high register 
Destination Y 
low register 


Destination Y 
high register 


LSB 


Number of dots 
X low register 


Number of dots 
X high register 
Number of dots 
Y low register 


Number of dots 
Y high register 


LSB 


Color register 


Argument 
register 


Command 
register 
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2.2. Status registers #0 to #9 


The following status registers are read-only registers for VDP status reporting. Let’s 
consider each register. 


MSB 7 6 5 4 3 2 1 O LSB 
S#0 F 5S C 5SN Status register 0 


7 F Vertical scan interrupt flag. \Nhen S#0 is read, this flag is reset 
6 5S Flag for 5” sprite. Five (or nine in G3...G7 modes) sprites are aligned on 
the same horizontal line 
5 C Collision flag. Two sprites have collided 
4..0 5SN The number of 5™ (or 9* in G3...G7 modes) sprite 


MSB 7 6 5 4 3 2 1 O LSB 
S#1 FL | LPS ID # FH Status register 1 


7 FL Light pen. Is set if light pen detects light. If IE2 is set, interrupt is 
generated. Reset when S#1 is read. 
Mouse 2. Is set if second button of mouse was pressed. This flag is not 
reset when reading status register S#1 

6 LPS Light pen button. Is set when light pen button is pressed 
Mouse 1. Is set if first button of mouse was pressed 
This flag is not reset when reading status register S#1 in both set-ups 

5...1 ID# The identification number of the VDP chip 

0 FH Horizontal scan interrupt flag. Is set if VDP scans line specified in register 

R#19. If IE1 is set, interrupt is generated. FH is reset when S#1 is read 


MSB 7 6 5 4 3 2 1 O LSB 
S#2 TR | VR | HR | BD 1 1 EO | CE Status register 2 


7 TR Transter ready flag. If set to 1, indicates to the CPU that VDP is ready for 
next transfer. Value of 0 means that VDP is not ready 

6 VR Vertical retrace flag. Is set during scanning of VBLANK area of the screen, 
i.e. during vertical retrace plus while lower and upper borders of the 
screen is drawn 


5 HR Horizontal retrace flag. Is set during scanning of HBLANK area of the 
screen, i.e. when right and left borders of the screen are drawn 
4 BD Color detect flag. When the search command is executed, this flag is set if 


specified color was detected 

1 EO Display field flag. If set to 0, indicates the first field. If set to 1, indicated 
the second field 

0 CE Command execution flag. If set to 1, indicates that VDP is busy executing 
a command 
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MSB 7 6 5 4 3 2 1 0 LSB 


S#3 X7 | X6 | X5 | X4 | X3 X2 | X1 X0 Column register 
low 

S#4 1 1 1 1 1 1 1 X8 Column register 
high 

S#5 Y7 | Y6 | Y5 | Y4 | Y3 | Y2 | Yi | YO Row register 
low 

S#6 1 1 1 1 1 1 Y9 Y8 Row register 
high 


The above registers S#3...S#6 contain coordinate information about collision location 
of the sprites, or location of light pen, or relative movement of the mouse. 


MSB 7 6 5 4 3 2 1 O LSB 
S#7 C7 | C6 | C5 | C4 | G C2 Ci CO Color register 


This color register is used when executing commands “POINT” and “VRAM to CPU” 
and contains VRAM data. 


MSB 7 6 5 4 3 2 1 0 LSB 


S#8 BX7 | BX6 | BX5 | BX4 | BX3 | BX2 | BXi | BXO Coded color X 
register low 
S#9 1 1 1 1 1 1 1 BX8 Coded color X 


register high 


When the search command is executed and coded color had been detected (see R#2), 
this register contains its X coordinate. 
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3. SCREEN MODES 
3.1. TEXT1 mode 


Pattern size (w*h) 6 dots * 8 dots 


Patterns 256 types 
Screen size (w*h) 40 * 24 patterns 
Pattern colors Two colors out of 512 (per screen) 


VRAM area per screen 4K bytes 


Pattern font VRAM pattern generator table 
Screen pattern location VRAM pattern name table 
Pattern color code 1 High-order four bits of R#7 
Pattern color code 0 Low-order four bits of R#7 
Background color code Low-order four bits of R#7 
Bit M5 (R#0) | M4 (R#0) | M3 (R#0) | M2 (R#1) | M1 (R#1) 
Value 0 0 0 0 1 
BASIC SCREEN number Pattern generator Pattern layout 
0, width 1 ... 40 00800h ... OOFFFh 00000h ... OO3BFh 
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3.1.2. Pattern Generator Table 


The pattern generator table is a location in VRAM that stores patterns (font). Each 
pattern has number from PNO to PN255. The font displayed on the screen for each pattern 
is constructed from 8 bytes, with 6 high-order bits displayed and 2 low-order bits not 
displayed. Pattern generator table base is stored in the register R#4. 


Example of pattern generator table is provided below. 


MSB LSB 
Offset | 7 
0 


Pattern number o (PNO) 


1 
2 
3 
4 
5 
6 
Z 
8 


10 


Pattern number 1 (PN1) 


2040 
2041 
2042 
2043 Pattern number 255 
2044 (PN255) 

2045 
2046 
2047 
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3.1.3. Pattern Layout Table settings 


The pattern layout table is a map of the screen (per screen image). Every location of 
the screen contains code of the pattern displayed at respective location. This table has 
40*24 (960) locations where defined patterns can be displayed. Pattern layout table base 
address is stored in register R#2, and corresponds to the cell (0, 0) with address 0 in the 
picture below. 


Columns 


(0) 0 1 2 Oiseau see. a 39 
al 1 40 41 42 co | One ee ae eee 79 
= E ee aes ee ee E 
(e) 
aa ee i i i 
22 880 881 882 | ads P tee YM 919 
23 920 921 922 M es Cee eee eee eee 959 
‘i 
Y 


3.1.4. Color register settings 

Color settings are located in the register R#7. Bits TC3...TCO specify pattern color 
code of the pixels identified as “1” in the bitmap values of pattern generator table, bits 
BD3...BDO specify pattern color code of the pixels identified as “0” in the bitmap values of 
pattern generator table as well as screen border color. 


Note: screen border color is the same as the pattern backdrop color in TEXT1 mode. 
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3.1.5. Example of VRAM allocation for TEXT1 mode 


00000h Pattern layout MSB 7 6 5 4 3 2 1 O LSB 
table 0 R#2 |0/0;0{|0/0;]0/01|0 
A16 A15 A14 A13 A12 A11 A10 
003BFh 
00800h | Pattern generator MSB 7 6 5 4 3 2 1 0 LSB 
table 0 R#4 /0/0/0/0/0/0|0]1 
A16 A15 A14 A13 A12 A11 
OOFFFh 
01000h | Pattern layout MSB 7 6 5 4 3 2 1 O0 LSB 
table 1 R#2 [oľololoļoļıļolo 
A16 A15 A14 A13 A12 A11 A10 
013BFh 
01800h | Pattern generator MSB 7 6 5 4 3 2 1 0 LSB 
table 1 R#4 [oloļoloļoļoļiı[ı 
A16 A15 A14 A13 A12 A11 
O1FFFh 
| Maximum of 32 pages may be allocated in the same 
: manner if VDP has 128K bytes attached to it. 
1FFFFh | | 
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3.2. TEXT2 mode 


Pattern size (w*h) 


6 dots * 8 dots 


Patterns 


256 types 


Screen size (w*h) 


80 * 24 patterns if LN bit of R#9 set to 0 
80 * 26.5 patterns if LN bit of R#9 set to 1 


Pattern colors 


Two colors out of 512 (per screen), four if using blinking 


VRAM area per screen 


8K bytes 


Pattern font 


VRAM pattern generator table 


Screen pattern location 


VRAM pattern name table 


Pattern color code 1 


High-order four bits of R#7 


Pattern color code 0 


Low-order four bits of R#7 


Background color code 


Low-order four bits of R#7 


Blinking pattern color 
code 1 


High-order four bits of R#12 


Blinking pattern color 
code 0 


Low-order four bits of R#12 


Bit 


Mode flags 


M5 (R#0) M3 (R#0) | M2 (R#1) 


M4 (R#0) 
1 


M1 (R#1) 
1 


0 0 0 


Other flags 
LN bit of R#9 


0: 24 lines displayed 
1: 26.5 lines displayed 


BASIC SCREEN number 


MSX system default values 


Pattern generator Pattern layout Pattern color table 


0, width 41 ... 80 


01000h ...017FFh | 00000h ... 0077Fh 


00000h ... OO86Fh 


00800h ... OO8EFh 
00800h ... 0090Dh 
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3.2.2. Pattern Generator Table 


Organization of pattern generator table is the same as in TEXT1 mode. Register R#4 
defines base address of the table. 


3.2.3. Pattern layout table settings 


The pattern layout table is a map of the screen (per screen image). Every location of 
the screen contains code of the pattern displayed at respective location. This table has 
80*27 (2160) locations where defined patterns can be displayed. Pattern layout table base 
address is stored in register R#2 (see below), and corresponds to the cell (0, 0) with 
address 0 in the picture below. Note that if LN bit of R#9 is set to 1, then 26 lines are 
displayed, plus an upper half of 27" pattern line is displayed. 


MSB 7 6 5 4 3 2 1 0 LSB 
R#2 0 A16 | A15 | A14 | A13 | A12 1 1 Pattern layout 
table 


Screen mapping of pattern layout table is provided below. 


Columns 


o 0 1 2 CaP |e es me 79 
aL 2 80 81 82 O's E E T satel 159 
> E E E T I. A TE NE EN EEA A E an te 
[e] 
oc nee vee PUT oe one Be a a tab 
25 2000 2001 2002 | wire a Me E a ol 2079 
26 2080 2081 20821] a ead a ee 2159 
t 
Y 


3.2.4. Color table settings 

Each position on the screen has separate bit for the blinking attribute, and if this bits 
is set to 1, blinking will be applied to the pattern placed in this area in the pattern layout 
table. Table start address is set in registers R#3 and R#10. 


MSB 7 6 5 4 3 2 1 0 LSB 


R#3 A13 | A12 | A11 | A10 | A9 1 1 1 Color table base 
R#10 olol o|o | o lailai] a4| address 
registers 
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Screen mapping of color table is provided below. 


MSB 7 6 5 4 3 2 1 0 LSB 
0| (0,0) (1, 0) (2, 0) (3, 0) (4, 0) (5, 0) (6, 0) (7, 0) 
1| (8,9) (9,0) | (10,0) | (11,0) | (12,0) | (13,0) | (14,0) | (15, 0) 


OZ, 26) | 73, 26) (79,26) | 


269 


3.2.5. Color register settings 


Color settings are located in the registers R#7 and R#12. 

Bits TC3...TCO of R#7 specify pattern color code of the pixels identified as “1” in the 
bitmap values of pattern generator table, bits BD3...,BDO specify pattern color code of the 
pixels identified as “0” in the bitmap values of pattern generator table as well as screen 
border color. Alternate blinking color is set in R#12. 


Note: screen border color is the same as the pattern backdrop color in TEXT2 mode. 


3.2.6. Blink register settings 


Color codes set in registers R#7 and R#12 will be alternately displayed; programmer 
can control period of blinking (time on and time off) through register R#13. 


R#12 R#7 R#12 
|<— Ontime —> | <— Offtime — | 
MSB 7 6 5 4 3 2 1 0 LSB 
R#13 ON3 | ON2 | ON1 | ONO | OF3 | OF2 | OF1 | OFO Blinking period 
On time Off time register 
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The NTSC timing data is provided in the table below. 


Delay data (binary) Time (ms) Delay data (binary) Time (ms) 
0000 0 1000 1335.1 
0001 166.9 1001 1509.9 
0010 333.8 1010 1668.8 
0011 500.6 1011 1835.7 
0100 667.5 1100 2002.6 
0101 834.4 1101 2169.5 
0110 1001.3 1110 2336.3 
0111 1168.2 1111 2503.2 
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3.2.7. Example of VRAM allocation for TEXT2 mode 


00000h Pattern layout MSB 7 6 5 4 3 2 1 0 LSB 
table 0 R#2 |0/0/;0/0;0/;0/;1]1 
A16 A15 A14 A13 A12 
00870h 
00A00h Color table 0 MSB 7 6 5 4 3 2 1 0 LSB 
R#3 /0/0/;1;0;1]1]141 
OOBOEh A13 A12 A11 A10 A9 
01000h | Pattern generator MSB 7 6 5 4 3 2 1 0 LSB 
table 0 R#10 [oļolololololļolo 
A16 A15 A14 
01800h 
' MSB 7 6 5 4 3 2 1 0 LSB 
' ' R#41|0/0;0|0/;0;}0/11|0 
02000h Pattern layout A16 A15 A14 A13 A12 Ali 
table 1 
02870h 
02A00h Color table 1 
02B0Eh 
03000h | Pattern generator | 
table 1 
03800h 
04000h | | 
: Maximum of 16 pages may be allocated in the same 
: manner if VDP has 128K bytes attached to it. 
LEFFFh | | 
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3.3. MULTICOLOR (MC) mode 


Screen composition (w*h) | 64 * 48 color blocks 

Color blocks Sixteen colors out of 512 colors 
Sprite mode Sprite mode 1 

VRAM area per screen 4K bytes 


Color block color code VRAM pattern generator table 
Color block location VRAM pattern name table 
Background color code Low-order four bits of R#7 
Sprites VRAM sprite attribute table 


VRAM sprite pattern table 


Mode flags 


Bit M5 (R#0) | M4 (R#0) | M3 (R#0) | M2 (R#1) | M1 (R#1) 
Value 0 0 0 1 0 
BASIC SCREEN Pattern Pattern layout | Sprite patterns Sprite 
number generator attributes 
3 00000h ... 00800h ... 03800h ... 01B00 ... 
007FFh OOAFFh O3FFFh 01B7Fh 
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3.3.1. Pattern Generator Table 


Each pattern is made up of four color blocks. These patterns are of size of 8*8 for the 
screen display of 256*192 dots. 


<— 8 dots —> 
Block A Block B ij For each block A, B, C, and D sixteen colors can be 
specified. Two bytes are used for each pattern. 

8 dots 

Block C Block D 

MSB 7 6 5 4 3 2 1 0 LSB 

Color code A Color code B 
Color code C Color code D 


There’re four color blocks (8 bytes) for each pattern layout location. Specific color 
block is used to display depending on the y-coordinate. 


MSB 7 6 5 4 2 1 

A B Color code A Color code B 
= C D Color code C Color code D 
+ 
g E F Color code E Color code F 
© G H Color code G Color code H 
Cc 
g I J Color code I Color code J 
€| K Color code K Color code L 

M N Color code M Color code N 

O P Color code O Color code P 


LSB 
Color of the pattern when 
y=0, 4, 8, 12, 16 or 20 


Color of the pattern when 
y=1, 5, 9, 13, 17 or 21 


Color of the pattern when 
y=2, 6, 10, 14, 18 or 22 


Color of the pattern when 
y=3, 7, 11, 15, 19 or 23 


Start of the pattern generator table should be set in register R#4. 


3.3.2. Pattern layout table settings 


The pattern layout table is a map of the screen (per screen image), containing one 
byte for each screen location. Each byte specifies unique pattern number. Start of the 
pattern name table should be set in register R#2. 
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Columns 


(0) 0 1 2 3e IM aa oe 31 
n| 2 32 33 34 Ca eee ee ee ee 63 
2 RRR ee: eee eee ene on Nea COREE een eee ee eee eine Seema ees 
a ee ee 
22 704 705 706 | e E iste cee aeea! 735 
23 736 737 738 a ee ee ee a 767 
t 
Y 


3.3.3. Color register settings 


You can set color of the margin of the screen (backdrop color) specifying BD3...BDO 
bits in register R#7. Note that bits TC3...TCO of R#7 are ignored. 


3.3.4. Sprite settings 


Set the start address of the sprite attribute table in registers R#5 and R#11; set start 
address of the sprite pattern generator table in register R#6. For details about sprites 
please refer to section “Sprite mode 1”. 
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3.3.5. Example of VRAM allocation for MULTICOLOR mode 


00000h 


00400h 


Sprite generator 
table 0 


00400h 


00700h 


Pattern layout 
table 0 


00700h 


00780h 


Sprite attribute 
table 0 


00800h 


Pattern generator 


table 0 


01000h | 


LFFFFh | 
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3.4. GRAPHI C1 (G1) mode 


Characteristics 
Pattern size (w*h) 


8 dots * 8 dots 


Patterns 


256 types 


Screen size (w*h) 


32 * 24 patterns (256 * 192 pixels) 


Pattern colors 


16 colors out of 512 (per screen) 


Sprite mode 


Sprite mode 1 


VRAM area per screen 


4K bytes 


Controls 
Pattern font 


VRAM pattern generator table 


Screen pattern location 


VRAM pattern name table 


Pattern color codes 1 & 0 


Specified as a group for each 8-bit pattern in color table 


Background color code 


Low-order four bits of R#7 


Sprites 


VRAM sprite attribute table 
VRAM sprite pattern table 


Mode flags 


Bit M5 (R#0) | M4 (R#0) | M3 (R#0) | M2 (R#1) | M1 (R#1) 
Value 0 0 0 0 0 
BASIC SCREEN Pattern Pattern Pattern Sprite patterns Sprite 
number generator layout colors attributes 
1 00000h ... 01800h ... 02000h ... 03800h ... 01B00 ... 
017FFh 01AFFh 0201Fh O3FFFh 01B7Fh 


© 1985 ASCII CORP. / NIPPON GAKKI CO. 


Page 38 of 108 


© 2010-2015 Eugeny Brychkov 


3.4.1. Pattern Generator Table 


The pattern generator table is a location in VRAM that stores patterns (font). Each 
pattern has number from PNO to PN255. The font displayed on the screen for each pattern 
is constructed from 8 bytes, with all 8 bits of each byte displayed. Pattern generator table 
base is stored in the register R#4. Example of pattern generator table is provided below. 


MSB LSB 
Offset}7/6/5/4/3/)/2/1/0 
0 


Pattern number o (PNO) 


W |} COIN) O00} 07) BR] QIN] 


11 Pattern number 1 (PN1) 


Pattern number 255 
(PN255) 


3.4.2. Pattern layout table settings 


The pattern layout table is a map of the screen (per screen image). Every byte 
location of the screen contains code of the pattern displayed at respective location. This 
table has 32*24 (767) locations where defined patterns can be displayed. Pattern layout 
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table base address is stored in register R#2, and corresponds to the cell (0, 0) with 
address 0 in the picture below. 


Columns 


o 0 1 2 3 ee ee eee 31 
a 2 32 33 34 Cl a |e eee ee 63 
(e) 
a ee i i i 

22 704 705 7067: Irra re 222k te. eRe t04l 735 

23 736 737 Aei Mercere Oy at ee E 767 

i} 
O Y 


3.4.3. Color register settings 

You can set color of the margin of the screen (backdrop color) specifying BD3...BDO 
bits in register R#7. Note that bits TC3...TCO of R#7 are ignored. 

3.4.4. Color table settings 

Table start address is set in registers R#3 and R#10. 


MSB 7 6 5 4 3 2 1 0 LSB 


R#3 A13 | Al2 | A11 | A10 | A9 | A8 | A7 | A6 | Color table base 
R#10 olo lo |o | o laislais]ar]| address 
registers 


Color table size is 32 bytes, each byte organized in the same way as register R#7 (FC 
is foreground color, BC is background color). Patterns 0...7 are assigned the first color 
from color table, patterns 8...15 are assigned second color from the color table, etc, and 
patterns F8h...FFh are assigned 31* color from the color table. Color table map is provided 
below. 


MSB 7 6 5 4 3 2 1 0 LSB 
0 | FC3 | FC2 | FC1 | FCO | BC3 | BC2 | BC1 | BCO | Color for patterns 0...7 
1| FC3 | FC2 | FC1 | FCO | BC3 | BC2 | BC1 | BCO | Color for patterns 8...15 


31 | FC3 | FC2 | FC1 | FCO | BC3 | BC2 | BCi | BCO | Color for patterns F8...FF 
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3.4.5. Sprite settings 
Set the start address of the sprite attribute table in registers R#5 and R#11; set start 


address of the sprite pattern generator table in register R#6. For details about sprites 
please refer to section “Sprite mode 1”. 


3.4.6. Example of VRAM allocation for GRAPHI C1 mode 


00000h | Sprite generator 

table 0 
00400h 
00400h Pattern layout 

table 0 
00700h 
00700h | Sprite attribute 

table 0 
00780h 
00800h | Pattern generator | 

table 0 
01000h 

| | Maximum of 32 pages may be allocated in the same 
: manner if VDP has 128K bytes attached to it. 

1FFFFh | 
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3.5. GRAPHI C2 (G2) and GRAPHI C3 (G3) modes 


Pattern size (w*h) 8 dots * 8 dots 

Patterns 768 types (256 per % of the screen) 
Screen size (w*h) 32 * 24 patterns (256 * 192 pixels) 
Pattern colors 16 colors out of 512 (per screen) 
Sprite mode* Sprite mode 1 (GRAPHIC 2) 

Sprite mode 2 (GRAPHIC 3) 

VRAM area per screen 16K bytes 

* GRAPHIC modes 2 and 3 are identical except for sprite modes 


Pattern font VRAM pattern generator table 

Screen pattern location VRAM pattern name table 

Pattern color codes 1&0 | Specified in pattern color table for 8-pixel groups 
Background color code Low-order four bits of R#7 

Sprites VRAM sprite attribute table 

VRAM sprite pattern table 


Mode flags: GRAPHI C2 


Bit M5 (R#0) 


M4 (R#0) 


M3 (R#0) 


M2 (R#1) 


M1 (R#1) 


Value 


0 


0 


1 


0 


0 


Bit 


M5 (R#0) 


M4 (R#0) 


M3 (R#0) 


M2 (R#1) 


Mode flags: GRAPHI C3 


M1 (R#1) 


Value 


0 


1 


0 


0 


0 


MSX system default values 


BASIC Pattern Pattern Pattern Sprite Sprite Sprite 
SCREEN generator layout colors patterns attributes colors 
number 

G2: 2 01B00 ... a 

` 00000h ... | 01800h ... | 02000h ... | 03800h ... 01B7Fh 
G3: 4 017FFh 01AFFh 037FFh O3FFFh 01E00... | 01COOh... 
j 01E7Fh 01DFFh 
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3.5.1. Screen map and pattern tables 


Unlike in other modes, in this mode screen is divided vertically into three logical parts. 
Every part has its own pattern generator and pattern color tables, but all of them share the 
same pattern layout table, one after another. Screen map is provided below. 


Columns 


o 0, 0 1,0 2,0 BAO Me es Be eek e. 31,0 |c 
1 0,1 1,1 2,1 2 a |e ee ea 31,1 | 28 
Rhee pcg teats Platoon gy tetas Res plots Meh, E E 8) oa 
; ee acted an akan 
0,7 1,7 2,7 Pans ares ae ab. = 
0, 8 1,8 Ph ae ee ee SO eee 31,8 | se 
a rr x 
a) O 
z E r ce ene ee aa =i 
ss 
55 
Xo 
x O 
=o 
22 = © 
23 ve 
T 
Y 


(base address) 00000h 


007FFh 
00800h 


OOFFFh 
01000h 


017FFh 
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Pattern generator table 


Pattern images for upper 
Ys of the screen 
(256) 


Pattern color table 


Pattern images for middle 
Ys of the screen 
(256) 


Pattern colors for upper 
Ys of the screen (256) 


Pattern images for lower 
Ys of the screen 
(256) 


Pattern colors for middle 
3 of the screen (256) 


Pattern colors for lower “% 
of the screen (256) 
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3.5.2. Pattern Tables 


The pattern generator table is a location in VRAM that stores patterns (font). Each 
pattern has number from PNO to PN255, for every % of the screen. The font displayed on 
the screen for each pattern is constructed from 8 bytes, with all 8 bits of each byte 
displayed. Pattern generator table base is stored in the register R#4. 


MSB 7 6 5 4 3 2 1 0 LSB 
R#4 0 O | A16 | A15 | A14 | A13 1 1 Pattern 
generator table 
base address 


The pattern layout table is a map of the screen (per screen image). Every byte 
location of the screen contains code of the pattern displayed at respective location. This 
table has three 32*8 locations (upper, middle and lower) arranged consecutively where 
defined patterns can be displayed. Pattern layout table base address is stored in register 
R#2, and corresponds to the cell (0, 0) with address 0 in the picture below. 


Example of pattern generator table is provided below. Color table identifies color 1 
(upper four bits) and color O (lower four bits) for every row of the pattern. 


MSB LSB MSB LSB 
Offset 211 0 71615/411/321 | 0 | Offset 
1/1/1/1/0/0/0/;0]|0 
1/i1/1i/i1/o0/O0/O0/o/1 
1/1/1/1/0/0/0/0)]2 
Pattern 1/1/1/1/0/0/0/0)]3 
number0/1/1/1/1/0/0/0/0/4 
(PNO) 1/1/1/1/0/0/0/0)/5 
1/1/1/1/0|0/0/0/6 
1/1/1/1/0/0/0/0|7 
1/1/1/1/0}0/0|0|8 
1/1/1/1/0/;0/0/0|9 
1/1/1/1/0/0/0/0| 10 
Pattern 1/1/1/1/0/0/0/0} 11 
number 1 /1/1/1/1/0/0/0/0/12 
(PN1) 1/1/1/1/0/0]/0/0/ 13 
1/1/1/1/0/0/0/0} 14 
1/1/1/1/0/0/0/0]| 145 
(J e (J 
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(J e (J 
(J e (J 
2040 1/1/1/1/0/0/0/0 | 2040 
2041 1/i1)/1{/1)/0{|0)0|0) 2041 
2042 1/1i/1/1)/0/0)01|0 | 2042 
2043 Pattern 1/1i/)/1/1/)0/0|0|0 | 2043 
2044 number 1/1i)/1/1);/0|0)0|0) 2044 
2045 255 1/1/1/1/0)/0/0)]0 | 2045 
2046 (PN255) [1/1/1]/1]/0]/0/0/0 | 2046 
2047 1/1/1/1/0/0/010 |2047 
Color 1 Color 0 
3.5.3. Color table settings 
Table start address is set in registers R#3 and R#10. 
MSB 7 6 5 4 3 2 1 0 LSB 
R#3 A13 1 1 1 1 1 1 1 Color table base 
R#10 0 | 0] 01) 0 | o |Al6|)Ai5|Ai4| address 
registers 


3.5.4. Color register settings 

You can set color of the margin of the screen (backdrop color) specifying BD3...BDO 
bits in register R#7. Note that bits TC3...TCO of R#7 are ignored. 

3.5.5. Sprite settings 

Set the start address of the sprite attribute table in registers R#5 and R#11; set start 
address of the sprite pattern generator table in register R#6. For details about sprites in 


GRAPHIC2 mode, please refer to section “Sprite mode 1”; for details about sprites in 
GRAPHIC3 mode, please refer to section “Sprite mode 2” 
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3.5.6. Example of VRAM allocation for GRAPHI C2 and GRAPHI C3 modes 


00000h | Pattern generator 
table, upper 
007FFh 
00800h | Pattern generator , __GRAPHIC2 mode GRAPHI C3 mode 
table, middle | Sprite — | 01800h Sprite | 01800h 
2 pattern pattern 
OOFFFh a table table 
01000h | Pattern generator a 01BFFh 01BFFh 
table, lower = | Sprite |01C00h | Sprite color | 01C00h 
017FFh | | attribute table 
l table 
' ; 01C7Fh 01DFFh 
02000h Pattern color =|, Sprite 01E00h 
table, upper { attribute 
N table 
027FFh N 01E7F 
02800h | Pattern color N, 
table, middle K O1FFFh O1FFFh 
02FFFh 
03000h Pattern color 
table, lower 
037FFh 
03800h Pattern layout 
table 
03AFFh 
04000h 
: Maximum of 8 pages may be allocated in the same manner 
i ` if VDP has 128K h it. 
1FFFFh | | i as 128K bytes attached to it 
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3.6. GRAPHI C4 (G4) mode 


Bit-mapped Graphics mode 

Screen size (w*h) 256 * 192 pixels if LN bit of R#9 set to 0 
256 * 212 pixels if LN bit of R#9 set to 1 

Pattern colors 16 colors out of 512 (per screen) 

Sprite mode Sprite mode 2 

VRAM area per screen 32K bytes 


Graphics VRAM pattern name table 

Background color code Low-order four bits of R#7 

Sprites VRAM sprite attribute table 
VRAM sprite pattern table 


Mode flags 


Bit M5 (R#0) | M4 (R#0) | M3 (R#0) | M2 (R#1) | M1 (R#1) 
Value 0 1 1 0 0 
MSX system default values 
BASIC SCREEN Pattern layout Sprite patterns Sprite Sprite colors 
number (bitmap) attributes 
07800h ... 07600 ... 07400h ... 
7 PUNON ee GORE O7FFFh 0767Fh 075FFh 
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3.6.1. Pattern layout table settings 


The pattern layout table is a map of the screen (per screen image). Every byte 
location of the screen contains color codes for two dots. This is bitmap graphics mode, 
and there’s no pattern generator table. 


Columns 


> Se ae ee NE et oe fe. 
2 mem | 0,191 1,191 | 2,191 ws, a tt 255,191 | LN=0 
mem | 0,211 3 1,211 | 2,212 3 we be Ee 255,211 | LN=1 
ij 
Y 
MSB 7 6 5 4 3 2 1 0 LSB 
0 Color code for (0, 0) Color code for (1, 0) Base address 
1 Color code for (2, 0) Color code for (3, 0) 
127 | Color code for (254, 0) Color code for (255, 0) 
128 Color code for (0, 1) Color code for (1, 1) 
27134 Color code for (252, 211) Color code for (253, 211) 
27135 Color code for (254, 211) Color code for (255, 211) 


Pattern layout table base address is stored in register R#2, and corresponds to the 
cell (0, 0) in the picture above. 


MSB 7 6 5 4 3 2 1 0 LSB 
R#2 O | A16 | A15 1 1 1 1 1 Pattern layout 
table base 
address 


3.6.2. Color register settings 


You can set color of the margin of the screen (backdrop color) specifying BD3...BDO 
bits in register R#7. Note that bits TC3...TCO of R#7 are ignored. 
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3.6.3. Sprite settings 

Set the start address of the sprite attribute table in registers R#5 and R#11; set start 
address of the sprite pattern generator table in register R#6. For details about sprites 
please refer to section “Sprite mode 2” 


MSB 7 6 5 4 3 2 1 0 LSB 


R#5 A14 | A13 | A12 | A11 | A10 | 1 1 1 Sprite attribute 
table low 

R#11 0 0 0 0 0 O | A16 | A15 Sprite attribute 
table high 

R#6 0 O | A16 | A15 | A14 | A13 | A12 | Ali Sprite pattern 


generator table 


3.6.4. Example of VRAM allocation for GRAPHI C4 mode 


00000h Pattern name 
table 
02000h | Sprite 07000h 
/ | pattern 
i table 
04000h / 
re Sprite color | 07800h 
| 192 lines x table 
06000h 1 
212 lines / 
06A00h r Sprite | 07A00h 
h attribute 
07000h table 
07A80h 
08000h : Ca 
1FFFFh | | Maximum of 4 pages may be allocated in the same manner 


if VDP has 128K bytes attached to it. 
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3.7. GRAPHIC5 (G5) mode 


Bit-mapped Graphics mode 

Screen size (w*h) 512 * 192 pixels if LN bit of R#9 set to 0 
512 * 212 pixels if LN bit of R#9 set to 1 

Pattern colors 4 colors out of 512 (per screen) 

Sprite mode Sprite mode 2 

VRAM area per screen 32K bytes 


Graphics VRAM pattern name table 

Background color code Low-order four bits of R#7 

Sprites VRAM sprite attribute table 
VRAM sprite pattern table 


Mode flags 


Bit M5 (R#0) | M4 (R#0) | M3 (R#0) | M2 (R#1) | M1 (R#1) 
Value 1 0 0 0 0 
MSX system default values 
BASIC SCREEN Pattern layout Sprite patterns Sprite Sprite colors 
number (bitmap) attributes 
07800h ... 07600 ... 07400h ... 
Š PUNON ee GORE O7FFFh 0767Fh 075FFh 
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3.7.1. Pattern layout table settings 


The pattern layout table is a map of the screen (per screen image). Every byte 
location of the screen contains color codes for four dots. This is bitmap graphics mode, 
and there’s no pattern generator table. 


Columns 


0, 0 1, 0 2,0 3,0 
1 0,1 1,1 2,1 Ca a ee ee ee ee ¢ oli, 1 | 
aa ae a een er ee eo, a ee 
2 191 | 0, 191 1,191 2, 191-$ ee ee ee ee ee 511,191 | LN=0 
gem | 0,211 1,211 2,211 8 ae tae Le 211,211 | LN=1 
t 
Y 
MSB 7 6 5 4 3 2 1 0 LSB 
0| Color code Color code Color code Color code | Base address 
for (0, 0) for (1, 0) for (2, 0) for (3, 0) 
1| Color code Color code Color code Color code 
for (4, 0) for (5, 0) for (6, 0) for (7, 0) 
127 Color code Color code Color code Color code 
for (508, 0) for (509, 0) for (510, 0) for (511, 0) 
128 | Color code Color code Color code Color code 
for (0, 1) for (1, 1) for (2, 1) for (3, 1) 
27135 | Color code Color code Color code Color code 
for (508, 211) for (509, 211) for (510, 211) for (511, 211) 


Pattern layout table base address is stored in register R#2, and corresponds to the 
cell (0, 0) in the picture above. 


MSB 7 6 5 4 3 2 1 0 LSB 
R#2 O | A16 | A15 1 1 1 1 1 Pattern layout 
table base 
address 
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3.7.2. Color register settings 

You can set color of the margin of the screen (backdrop color) specifying BD3...BDO 
bits in register R#7. Note that bits TC3...TCO of R#7 are ignored. 

3.7.3. Sprite settings 

Set the start address of the sprite attribute table in registers R#5 and R#11; set start 
address of the sprite pattern generator table in register R#6. For details about sprites 


please refer to section “Sprite mode 2” 


MSB 7 6 5 4 3 2 1 0 LSB 


R#5 A14 | A13 | A12 | A11 | A10 1 1 1 Sprite attribute 
table low 

R#11 0 0 0 0 0 O | A16 | A15 Sprite attribute 
table high 

R#6 0 0 A16 | A15 | A14 | A13 | A12 | All Sprite pattern 


generator table 


3.7.4. Hardware tiling function 


VDP can only display 4 solid colors in G5 mode however pixels are so small that 
combination of two pixels from the set of those 4 solid colors possible produces another 
visible color, a mixture of the applied two. 

This feature is only available in G5 mode, and is applied to the sprites and to the 
screen border color. G5 has 512 pixels in its X-axis, but sprites” X-coordinate is between 0 
and 255. This means that for single sprite dot there're two font pattern dots, and from forn 
pattern point of view sprite of 8*8 has size of 16*8. 

SM2 sprite color table uses 4 bits for each line of sprite. For every dot in sprite 
pattern table defined as “1” in sprite image bitmap, lower two bits from this 4-bit set 
define color of odd pixels of the sprite, and higher two bits from this set define color of 
even pixels of the sprite. 

In the example above imagine that palette color 1 is set to red (7, 0, 0) and color 3 
set to blue (0, 0, 7). 
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MSB LSB 


Actual sprite representation on the screen in 
G5 mode (8*8 size) 


Offset 


r p 
(0 @] 
2 E 
3 $ 
4 o 
5 g 
6 a 
7 
MSB LSB 
o|x|x|x]o Dh 
1ı|x|x|x|o PISSE | 
2|x|xix|o (Oe 5 
3/X|X|X|0 iim S 
4ix|x x o om © 
5|x|x|x|o Oe = 
6/xX|xX|xX|0 [Cel 
7/X|xX/X]|0 Konea 
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Sprite image — how sprite is seen (perceived) 
by the user in G5 mode 
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3.7.5. Example of VRAM allocation for GRAPHIC5 mode 


00000h 


02000h 


04000h 


06000h 


06A00h 


07000h 


08000h | 


LFFFFh | 


Pattern name 
table 


192 lines 


212 lines 


r~ 


Sprite 
pattern 
table 


Sprite color 
table 


Sprite 
attribute 
table 
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07000h 


07800h 


07A00h 


07A80h 


i Maximum of 4 pages may be allocated in the same manner 
if VDP has 128K bytes attached to it. 
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3.8. GRAPHI C6 (G6) mode 


Bit-mapped Graphics mode 

Screen size (w*h) 512 * 192 pixels if LN bit of R#9 set to 0 
512 * 212 pixels if LN bit of R#9 set to 1 

Pattern colors 16 colors out of 512 (per screen) 

Sprite mode Sprite mode 2 

VRAM area per screen 64K bytes 


Graphics VRAM pattern name table 

Background color code Low-order four bits of R#7 

Sprites VRAM sprite attribute table 
VRAM sprite pattern table 


Mode flags 


Bit M5 (R#0) | M4 (R#0) | M3 (R#0) | M2 (R#1) | M1 (R#1) 
Value 1 0 1 0 0 
MSX system default values 
BASIC SCREEN Pattern layout Sprite patterns Sprite Sprite colors 
number (bitmap) attributes 
OFOOOh ... OFAOO ... OF800h ... 
i SUDO CN ee DERE OF7FFh OFA7Fh OFOFFh 
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3.8.1. Pattern layout table settings 


The pattern layout table is a map of the screen (per screen image). Every byte 
location of the screen contains color codes for two dots. This is bitmap graphics mode, 
and there’s no pattern generator table. 


Columns 


0 |. ae 510,0 511,0 
1 514,1 | 


tn a se es eee Sees see’ 


eam |0211 1,211 | 2,211 8 an de aie, 911,211 | LN=1 
t 
Y 
MSB 7 6 5 4 3 2 1 0 LSB 
0 Color code for (0, 0) Color code for (1, 0) Base address 
1 Color code for (2, 0) Color code for (3, 0) 
255 | Color code for (510, 0) Color code for (511, 0) 
256 Color code for (0, 1) Color code for (1, 1) 
54270 Color code for (508, 211) Color code for (509, 211) 
54271 Color code for (510, 211) Color code for (511, 211) 


Pattern layout table base address is stored in register R#2, and corresponds to the 
cell (0, 0) in the picture above. 


MSB 7 6 5 4 3 2 1 0 LSB 
R#2 O | A16 1 1 1 1 1 1 Pattern layout 
table base 
address 


© 1985 ASCII CORP. / NIPPON GAKKI CO. Page 56 of 108 © 2010-2015 Eugeny Brychkov 


3.8.2. Color register settings 

You can set color of the margin of the screen (backdrop color) specifying BD3...BDO 
bits in register R#7. Note that bits TC3...TCO of R#7 are ignored. 

3.8.3. Sprite settings 

Set the start address of the sprite attribute table in registers R#5 and R#11; set start 
address of the sprite pattern generator table in register R#6. For details about sprites 


please refer to section “Sprite mode 2” 


MSB 7 6 5 4 3 2 1 0 LSB 


R#5 A14 | A13 | A12 | A11 | A10 1 1 1 Sprite attribute 
table low 

R#11 0 0 0 0 0 O | A16 | A15 Sprite attribute 
table high 

R#6 0 0 A16 | A15 | A14 | A13 | A12 | All Sprite pattern 


generator table 
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3.8.4. Example of VRAM allocation for GRAPHI C4 mode 


00000h 


04000h 


08000h 


0CO00h 


0D400h 


OF000h 


10000h | 


1FFFFh | 


Pattern name 
table 


192 lines 


212 lines 
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| Sprite 


pattern 
table 


Sprite color 
table 


Sprite 
attribute 
table 
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OFOOOh 


OF800h 


OFAOOh 


OFA80h 


i Maximum of 2 pages may be allocated in the same manner 
if VDP has 128K bytes attached to it. 
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3.9. GRAPHI C7 (G7) mode 


Bit-mapped Graphics mode 

Screen size (w*h) 256 * 192 pixels if LN bit of R#9 set to 0 
256 * 212 pixels if LN bit of R#9 set to 1 

Pattern colors 256 colors (per screen) 

Sprite mode Sprite mode 2 

VRAM area per screen 64K bytes 


Graphics VRAM pattern name table 

Background color code Low-order four bits of R#7 

Sprites VRAM sprite attribute table 
VRAM sprite pattern table 


Mode flags 


Bit M5 (R#0) | M4 (R#0) | M3 (R#0) | M2 (R#1) | M1 (R#1) 
Value 1 1 1 0 0 
MSX system default values 
BASIC SCREEN Pattern layout Sprite patterns Sprite Sprite colors 
number (bitmap) attributes 
OFOOOh ... OFAOO ... OF800h ... 
SUDO CN ee DERE OF7FFh OFA7Fh OFOFFh 
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3.9.1. Pattern layout table settings 


The pattern layout table is a map of the screen (per screen image). Every byte 
location of the screen contains color code for one single dot. This is bitmap graphics mode, 
and there’s no pattern generator table. 


Columns 


255,211 | LN=1 


t 
Y 
MSB 7 6 5 4 3 2 1 0 LSB 
0 Color code for (0, 0) Base address 
1 Color code for (1, 0) 
Green Red Blue 
255 Color code for (255, 0) 
256 Color code for (0, 1) 
27134 | Color code for (254, 211) 
27135 Color code for (255, 211) 


Pattern layout table base address is stored in register R#2, and corresponds to the 
cell (0, 0) in the picture above. 


MSB 7 6 5 4 3 2 1 0 LSB 


R#2 0 O | A16 1 1 1 1 1 Pattern layout 
** table base 
address 


**Note that in G6 and G7 modes location of bit A16 differs 
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3.9.2. Color register settings 


You can set color of the margin of the screen (backdrop color) specifying all the 8 bits 
in register R#7 (256 possible colors in total). 


MSB 7 6 5 4 3 2 i 0 LSB 
R#7 DB7 | DB6 | DB5 | DB4 | BD3 | BD2 | BD1 | BDO | Screen margin 
Screen margin / backdrop color color 


3.9.3. Sprite settings 

Set the start address of the sprite attribute table in registers R#5 and R#11; set start 
address of the sprite pattern generator table in register R#6. For details about sprites 
please refer to section “Sprite mode 2” 


MSB 7 6 5 4 3 2 1 0 LSB 


R#5 A14 | A13 | A12 | A11 | A10 1 1 1 Sprite attribute 
table low 

R#11 0 0 0 0 0 O | A16 | A15 Sprite attribute 
table high 

R#6 0 0 A16 | A15 | A14 | A13 | A12 | All Sprite pattern 


generator table 
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3.9.4. Example of VRAM allocation for GRAPHIC7 mode 


00000h 


04000h 


08000h 


0CO00h 


0D400h 


OF000h 


10000h | 


1FFFFh | 


Pattern name 
table 


192 lines 


212 lines 
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| Sprite 


pattern 
table 


Sprite color 
table 


Sprite 
attribute 
table 
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OFOOOh 


OF800h 


OFAOOh 


OFA80h 


i Maximum of 2 pages may be allocated in the same manner 
if VDP has 128K bytes attached to it. 
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4. COMMANDS 


4.1. Types of commands 


Commands are used to perform specific complex operations on the video memory, 
and thus on the image displayed on the screen. See the list of available commands in the 
table below. 


Command Destination Source Unit Mnemonic CM3 CM2 CM1 CMO 
name 

High-speed | VRAM CPU Byte | HMMC* 1 1 1 1 
move VRAM VRAM YMMM* 1 1 1 0 
VRAM VRAM HMMM 1 1 0 1 
VRAM VDP HMMV 1 1 0 0 
Logical VRAM CPU Dot | LMMC 1 0 1 1 
move CPU VRAM LMCM 1 0 1 0 
VRAM VRAM LMMM 1 0 0 1 
VRAM VDP LMMV 1 0 0 0 
Line VRAM VDP LINE 0 1 1 1 
Search VRAM VDP SRCH 0 1 1 0 
Pset VRAM VDP PSET 0 1 0 1 
Point VDP VRAM POI NT 0 1 0 0 
Invalid 0 0 1 1 
0 0 1 0 
0 0 0 1 
Stop STOP 0 0 0 0 


*In G4 and G6 modes, the lower one bit, and in G5 mode, the lower two bits are lost in registers related to 
X-coordinate (DX, NX) 


The process of execution of VDP commands consists of several steps: 

e Ensure that current mode is G4 — G7. In other modes result is not guaranteed 

e Check the bit 0 (CE, command execution) flag in status register S#2 to be 0. If it’s 
1, then previous command is in progress and program needs to wait for 
completion or issue STOP command 

e Set necessary parameters for command execution in registers R#32 to R#45 as 
necessary. It is easy to write whole the set of values to registers using indirect 
register addressing mode with auto-increment turned on 

e Write command code to the R#46 (CMR, command register) 

e Wait till command execution is completed by checking bit 0 (CE) of S#2 to be 0 

e If current command needs to be aborted, execute STOP command 
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4.2. Page concept 


As we have already seen, programmer can have several options to place tables in the 
video memory by altering base address registers. In some modes there’re more options 
(like in Text 1 there're 32 options and in GRAPHICS7 there're only 2 options). This 
introduces a concept of the page defined by where VDP currently operates and where it 
takes information for picture display from. 

Page concept is stricter in relation to VDP commands. VRAM access is defined by X 
and Y coordinates, and not by physical address within VRAM. Coordinate X is specified by 9 
bits, and can be in range of 0...511, coordinate Y is specified by 10 bits, and can be in 
range of 0...1023. See the table below for VRAM paging in various video modes. 


GRAPHIC4 Address GRAPHIC5 

(0, 0) (255, 0) 0000h (0, 0) (511, 0) 
Page 0 | Page 0 

(0, 255) (255, 255) | (0, 255) (511, 255) 

(0, 256) (255, 256) 08000h (0, 256) (511, 256) 
Page 1 | Page 1 

(0, 511) (255, 511) | (0, 511) (511, 511) 

(0, 512) (255, 512)| 10000h | (0, 512) (511, 512) 
Page 2 | Page 2 

(0, 767) (255, 767) | (0, 767) (511, 767) 

(0, 768) (255, 768) 18000h (0, 768) (511, 768) 
Page 3 | Page 3 

(0, 1023) (255, 1023)| 1FFFFh | (0, 1023) (511, 1023) 

GRAPHIC7 GRAPHIC6 

(0, 0) (255, 0) 0000h (0, 0) (511, 0) 
Page 0 | Page 0 

(0, 255) (255, 255) | (0, 255) (511, 255) 

(0, 256) (255, 256) 10000h (0, 256) (511, 256) 
Page 1 | Page 1 

(0, 511) (255,511)| 1FFFFh | (0, 511) (511, 511) 


In G4 and G5 modes there're four pages; in G6 and G7 modes there're only two 
pages. For example, setting Y coordinate in G5 mode to 658 will automatically choose page 
#2 with specific translated initial VRAM address. 

Note that VDP is capable of displaying maximum of 212 lines, and programmer has 
an option to use register R#23 to set visible screen window position within active page. 
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4.3. Logical operations 


When executing logical commands LINE, PSET and LOGICAL MOVE, it is possible to 
define logical operation to be done on the color of the pixels. The four bits identifying the 
logical operation should be written in lower four bits of R446 (command register) together 
with the command code. 


Operation 
IMP DC=SC 
AND DC=SC&DC 
OR DC=SC|DC 


XOR DC=SC“DC 
NOT DC=!SC 


Invalid 


TIMP If SC=0 then DC=DC else DC=SC 
TAND If SC=0 then DC=DC else DC=SC&DC 
TOR If SC=0 then DC=DC else DC=SC|DC 
TXOR If SC=0 then DC=DC else DC=SC^DC 
TNOT If SC=0 then DC=DC else DC=!SC 


Invalid 


Rl RR PR | OO OOO ;O;O/O 
RRR ie O;O;/O;/O;R RJR |F|/O;O/O|;O 


FIR OIOI.. OIOI.. OIO.. OIO 
=O. Ole loOleioleliolie lole joje o 


*SC = source color code 
*DC = destination color code 
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4.4. Explanation of the commands 


4.4.1. HMMC (High speed move CPU to VRAM) 


HMMC command is used to transfer data from the CPU to video or expansion RAM 
into a specified rectangular area through VDP. When using this command, note the 
limitation on the X coordinate in various modes (255 or 511). 


GP: Meg 


HMMC execution order 


VDP 


Video or expansion RAM 


(DX, DY) 


Step 1: Set necessary coordinates in command registers 


MSB 7 6 5 4 3 2 1 0 
R#36 DX7 | DX6 | DX5 | DX4 | DX3 | DX2 | DX1 | DXO 
R#37 0 0 0 0 0 0 0 | DX8 
R#38 DY7 | DY6 | DY5 | DY4 | DY3 | DY2 | DY1 | DYO 
R#39 0 0 0 0 0 0 | DYI | DY8 
R#40 NX7_ | NX6 | NX5 | NX4 | NX3 | NX2 | NX1 | NXO 
R#41 0 0 0 0 0 0 O | NX8 
R#42 NY7 | NY6 | NY5 | NY4 | NY3 | NY2 | NY1 | NYO 
R#43 0 0 0 0 0 O | NY9 | NY8 


*In G4 and G6 modes, 
X-coordinate (DX, NX) 


LSB 


DX*: 
Destination X 


DY: Destination 
Y 


NX*: Number of 
dots in X-axis 


NY: Number of 
dots in Y-axis 


the lower one bit, and in G5 mode, the lower two bits are lost in registers related to 


Step 2: Set color register value 


The first byte transferred from CPU after starting executing the HMMC command 
should be located in color register R#44 (CLR). Format of color data depends on the 


graphics mode. 
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MB 7 6 5 4 3 2 1 0 LSB 
R#44 CR7 | CR6 | CR5 | CR4 | CR3 | CR2 | CR1 | CRO | G4, G6 
=2N X=2N+1 (N=0..127) 


CR7 | CR6 | CR5 | CR4 | CR3 | CR2 | CR1 | CRO G5 (N=0...127) 
X=4N X=4N+1 X=4N+2 X=4N+4+3 


CR7 | CR6 | CR5 | CR4 | CR3 | CR2 | CRi | CRO G7 
X=N (One dot) 


Step 3: Select destination memory and direction from base coordinate 


MSB 7 6 5 4 3 2 1 0 LSB 


VRAM Destination 
: ExpRAM | select 


R#45 0 - MXD - DIY | DIX - - 
0: Right X transfer 
1: Left direction 
| 0: Down Y transfer 
| 1: Up direction 
0: 
il 


Step 4: Execute the command 


MSB 7 6 5 4 3 2 1 0 LSB 
R#46 1 1 1 1 E - - E HMMC cmd 


Step 5: Send data and wait for completion 


While command is being executed by VDP, CE bit of status register S#2 will be set to 
1. When command is complete, it will be reset to 0. 

When VDP sets TR bit of status register S#2 to “1” application can send next data to 
the VDP color register R#44 (CLR). If TR bit is 0, then application should not send data 
and wait till TR bit is set to 1 or terminate the command if needed. 
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Flowchart of HMMC execution from CPU point of view 


HMMC Start 
Set up VDP registers 


Read status register #2 


End of 
command? 
No (CE=1) 
Transmit 


ready? 


Yes (CE=0) 


Yes (TR=1) 


Data transmit (R#44) 
HMMC End 
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4.4.2. YMMM (High speed move VRAM to VRAM, Y coordinate only) 


YMMM command is used to transfer data from the area specified by DX, SY, NY, DIX, 
DIY and the right (or left) edge of the screen, in the Y-direction determined by DY. 


Video or expansion RAM 


— DIX 
| DIY 
YMMM execution order 
Step 1: Set necessary coordinates in command registers 
MSB 7 6 5 4 3 2 1 0O LSB 
R#34 SY7 | SY6 | SY5 | SY4 | SY3 | SY2 | SY1 | SYO SY: Source 
R#35 0 0 0 0 0 0 SY9 | SY8 transfer point Y 
R#36 DX7 | DX6 | DX5 | DX4 | DX3 | DX2 | DX1 | DXO DX*: Source 
R#37 0 0 0 0 0 0 0 | DX8 transfer point X 
R#38 DY7 | DY6 | DY5 | DY4 | DY3 | DY2 | DY1 | DYO DY: Destination 
R#39 0 0 0 0 0 0 | DY9 | DY8 transfer point Y 
R#42 NY7 | NY6 | NY5 | NY4 | NY3 | NY2 | NY1 | NYO NY: Number of 
R#43 0 0 0 0 0 O | NY9 | NY8 dots in Y-axis 


*In G4 and G6 modes, 
X-coordinate (DX, NX) 


the lower one bit, and in G5 mode, the lower two bits are lost in registers related to 
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Step 2: Select destination memory and direction from base coordinate 


MSB 7 6 5 4 3 2 1 0 LSB 


VRAM Destination 
: ExpRAM | select 


R#45 0 - MXD - DIY | DIX - - 
0: Right X transfer 
1: Left direction 
0: Down Y transfer 
1: Up direction 
0: 
1 


Step 3: Execute the command 


MSB 7 6 5 4 3 2 1 0 LSB 
R#46 1 1 1 0 E z - - YMMM cmd 


Step 4: Wait for command execution completion 


While command is being executed by VDP, CE bit of status register S#2 will be set to 
1. When command is complete, it will be reset to 0. 
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4.4.3. HMMM (High speed move VRAM to VRAM) 


HMMM command is used to transfer data from one specific rectangular area in VRAM 
of expansion RAM to another area within VRAM of expansion RAM. Note the limitation on 
the X coordinate, which is dependent on the current graphics mode (255 or 511). 


Video or expansion RAM 


HMMM execution order 
Step 1: Set necessary coordinates in command registers 


MSB 7 6 5 4 3 2 1 0 LSB 


R#32 SX7 | SX6 | SX5 | SX4 | SX3 | SX2 | SX1 | SXO SX*: Source 
R#33 0 0 0 0 0 0 0 SX8 transfer point X 
R#34 SY7 | SY6 | SY5 | SY4 | SY3 | SY2 | SY1 | SYO SY: Source 
R#35 0 0 0 0 0 0 SY9 | SY8 transfer point Y 
R#36 DX7 | DX6 | DX5 | DX4 | DX3 | DX2 | DX1 | DXO DX*:Destination 
R#37 0 0 0 0 0 0 0 | DX8 transfer point X 
R#38 DY7 | DY6 | DY5 | DY4 | DY3 | DY2 | DY1 | DYO DY: Destination 
R#39 0 0 0 0 0 0 DY9 | DY8 transfer point Y 
R#40 NX7 | NX6 | NX5 | NX4 | NX3 | NX2 | NX1 | NXO NX*: Number of 
R#41 0 0 0 0 0 0 0 NX8 dots in x-axis 
R#42 NY7 | NY6 | NY5 | NY4 | NY3 | NY2 | NY1 | NYO NY: Number of 
R#43 0 0 0 0 0 0 NY9 | NY8 dots in Y-axis 


*In G4 and G6 modes, the lower one bit, and in G5 mode, the lower two bits are lost in registers related to 
X-coordinate (DX, NX) 
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Step 2: Select destination memory and direction from base coordinate 
MSB 7 6 5 4 3 2 1 0 LSB 
R#45 0 - | MXD | MSX | DIY | DIX - - 


: Right X transfer 
Left direction 


: Down Y transfer 
direction 


VRAM Source 
: ExpRAM | location select 


VRAM Destination 
: ExpRAM | location select 


FO] |F oO]; |F Oo]; |F Oo 
= 
O 


Step 3: Execute the command 


MSB 7 6 5 4 3 2 1 0 LSB 
R#46 1 1 0 1 - S HMMM cmd 


Step 4: Wait for command execution completion 


While command is being executed by VDP, CE bit of status register S#2 will be set to 
1. When command is complete, it will be reset to 0. 
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4.4.4. HMMV (High speed move VDP to VRAM) 


HMMV command is used to paint in a specific rectangular area in the VRAM or 
expansion RAM. When using this command, note the limitation on the X coordinate in 
various modes (255 or 511). 


VDP 


HMMV execution order 


Video or expansion RAM 


Step 1: Set necessary coordinates in command registers 


R#36 
R#37 


R#38 
R#39 


R#40 
R#41 


R#42 
R#43 


*In G4 and G6 modes, 
X-coordinate (DX, NX) 


MSB 


7 6 5 4 3 2 1 0 
DX7 | DX6 | DX5 | DX4 | DX3 | DX2 | DXi | DXO 
0 0 0 0 0 0 0 | DX8 
DY7 | DY6 | DY5 | DY4 | DY3 | DY2 | DY1 | DYO 
0 0 0 0 0 0 | DY9 | DY8 
NX7 | NX6 | NX5 | NX4 | NX3 | NX2 | NX1 | NXO 
0 0 0 0 0 0 O | NX8 
NY7 | NY6 | NY5 | NY4 | NY3 | NY2 | NY1 | NYO 
0 0 0 0 0 O | NY9 | NY8 


Step 2: Set color register value 


LSB 


DX*: 
Destination X 


DY: Destination 
Y 


NX*: Number of 
dots in X-axis 


NY: Number of 
dots in Y-axis 


the lower one bit, and in G5 mode, the lower two bits are lost in registers related to 


The first byte transferred from CPU after starting executing the HMMC command 
should be located in color register R#44 (CLR). Format of color data depends on the 
graphics mode. 
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MSB 7 6 5 4 3 2 1 0 LSB 


R#44 CR7 | CR6 | CR5 | CR4 | CR3 | CR2 | CR1 | CRO 
=2N X=2N+1 


CR7 | CR6 | CR5 | CR4 | CR3 | CR2 | CR1 | CRO 
X=4N X=4N+1 X=4N+2 X=4N+4+3 


CR7 | CR6 | CR5 | CR4 | CR3 | CR2 | CR1 | CRO 
X=N (One dot) 


Step 3: Select destination memory and direction from base coordinate 


MSB 7 6 5 4 3 2 1 0 


G4, G6 
(N=0..127) 
G5 (N=0...127) 


G7 


LSB 


R#45 0 - |MXD| - DIY | DIX z z 


X transfer 
direction 


Y transfer 
direction 


Teles Sie 
gJ 
fo) 
= 
3 


Destination 
select 


Step 4: Execute the command 


MSB 7 6 5 4 3 2 1 O LSB 


R#46 1 1 0 0 - - 


Step 5: Wait for command execution completion 


HMMV cmd 


While command is being executed by VDP, CE bit of status register S#2 will be set to 


1. When command is complete, it will be reset to 0. 
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4.4.5. LMMC (Logical move CPU to VRAM) 


LMMC command is used to transfer data from the CPU to video or expansion RAM 
into a specified rectangular area through VDP. The units used are dots. 


Video or expansion RAM 


(DX, DY) 


CPU ————»| VDP 


LMMC execution order 
Step 1: Set necessary coordinates in command registers 


MSB 7 6 5 4 3 2 1 O LSB 


R#36 DX7 | DX6 | DX5 | DX4 | DX3 | DX2 | DXi | DXO DX: Destination 
R#37 0 0 0 0 0 0 0 DX8 X (0...511) 
R#38 DY7 | DY6 | DY5 | DY4 | DY3 | DY2 | DY1 | DYO DY: Destination 
R#39 0 0 0 0 0 0 DY9 | DY8 Y (0...1023) 
R#40 NX7 | NX6 | NX5 | NX4 | NX3 | NX2 | NX1 | NXO NX: Number of 
R#41 0 0 0 0 0 0 0 NX8 dots in X-axis 
R#42 NY7 | NY6 | NY5 | NY4 | NY3 | NY2 | NY1 | NYO NY: Number of 
R#43 0 0 0 0 0 0 NY9 | NY8 dots in Y-axis 


Step 2: Set color register value 


The first byte transferred from CPU after starting executing the LMMC command 
should be located in color register R#44 (CLR). Format of color data depends on the 
graphics mode. 


MSB 7 6 5 4 3 2 1 0 LSB 
R#44 - - z -| CR3 | CR2 | CR1 | CRO G4, G6 
- - - - -| CR1 | CRO G5 
CR7 | CR6 | CR5 | CR4 | CR3 | CR2 | CR1 | CRO G7 
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Step 3: Select destination memory and direction from base coordinate 


MSB 7 6 5 4 3 2 1 0 LSB 


VRAM Destination 
: ExpRAM | select 


R#45 0 - MXD - DIY | DIX - - 
0: Right X transfer 
1: Left direction 
0: Down Y transfer 
| 1: Up direction 
0: 
1 


Step 4: Execute the LMMC command 


MSB 7 6 5 4 3 2 1 0 LSB 
R#46 1 0 1 1 | LO3 | LO2 | LO1 | LOO LMMC cmd 
Logical operation 


Step 5: Send data and wait for completion 


While command is being executed by VDP, CE bit of status register S#2 will be set to 
1. When command is complete, it will be reset to 0. 

When VDP sets TR bit of status register S#2 to “1” application can send next data to 
the VDP color register R#44 (CLR). If TR bit is 0, then application should not send data 
and wait till TR bit is set to 1 or terminate the command if needed. 
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Flowchart of LMMC execution from CPU point of view 


LMMC Start 
Set up VDP registers 


Read status register #2 


End of 
command? 
No (CE=1) 
Transmit 


ready? 


Yes (CE=0) 


Yes (TR=1) 


Data transmit (R#44) 
LMMC End 
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4.4.6. LMCM (Logical move VRAM to CPU) 


LMCM command is used to transfer data from the video or expansion RAM in a 
specified rectangular area to the CPU through VDP. The units used are dots. 


Video or expansion RAM 


(SX, SY) 


CPU «| VDP 


LMCM execution order 
Step 1: Set necessary coordinates in command registers 


MSB 7 6 5 4 3 2 1 0 LSB 


R#32 SX7 | SX6 | SX5 | SX4 | SX3 | SX2 | SX1 | SXO SX: Source X 
R#33 0 0 0 0 0 0 0 SX8 (0...511) 

R#34 SY7 | SY6 | SY5 | SY4 | SY3 | SY2 | SY1 | SYO SY: Source Y 
R#35 0 0 0 0 0 0 SY9 | SY8 (0...1023) 
R#40 NX7 | NX6 | NX5 | NX4 | NX3 | NX2 | NX1 | NXO NX: Number of 
R#41 0 0 0 0 0 0 0 NX8 dots in X-axis 
R#42 NY7 | NY6 | NY5 | NY4 | NY3 | NY2 | NY1 | NYO NY: Number of 
R#43 0 0 0 0 0 0 NY9 | NY8 dots in Y-axis 


Step 2: Select source memory and direction from base coordinate 


MSB 7 6 5 4 3 2 1 0 LSB 


R#45 0 - - MXS | DIY | DIX - - 
0: Right X transfer 
1: Left direction 
0: Down Y transfer 
1: Up direction 
0: VRAM Source select 
1: ExpRAM 
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Step 3: Clear the TR flag 


Read the value from status register S#7. This step is required in order to clear the TR 
flag. Please refer to flowchart in this section for the LMCM command. 


Step 4: Execute the LMCM command 


MSB 7 6 5 4 3 2 1 0 LSB 
R#46 1 0 1 0 - - - z LMCM cmd 


Step 5: Read dot color code and check fir command end 


Use status register S#7 to get the color code of the dot. Format of color data 
depends on the graphics mode. 


MSB 7 6 5 4 3 2 1 0 LSB 
S#7 - - - - C3 | C2 | Ci | CO G4, G6 


z - E - E - Ci | CO G5 
C7 | C6 | C5 | C4 | C3 | C2 | C1 | CO G7 


Check CE bit of status register S#2 for command completion. CE set to 0 is the only 
sign of the completed LMCM command. 
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Flowchart of LMCM execution from CPU point of view 


LMCM Start 
Set up VDP registers* 


Read status register #2 


Transmit 
ready? 


No (TR=0) 


Read status register S#7 


Command 
end? 


Yes (CE=0) 


LMMC End 


*TR must be cleared before command execution 
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4.4.7. LMMM (Logical move VRAM to VRAM) 


LMMM command is used to transfer data from one specific rectangular area in VRAM 
of expansion RAM to another area within VRAM of expansion RAM. The units used are dots. 


Video or expansion RAM 


LMMM execution order 
Step 1: Set necessary coordinates in command registers 


MSB 7 6 5 4 3 2 1 0 LSB 


R#32 SX7 | SX6 | SX5 | SX4 | SX3 | SX2 | SX1 | SXO SX: Source 
R#33 0 0 0 0 0 0 0 SX8 transfer point X 
R#34 SY7 | SY6 | SY5 | SY4 | SY3 | SY2 | SY1 | SYO SY: Source 
R#35 0 0 0 0 0 0 SY9 | SY8 transfer point Y 
R#36 DX7 | DX6 | DX5 | DX4 | DX3 | DX2 | DX1 | DXO DX: Destination 
R#37 0 0 0 0 0 0 0 | DX8 transfer point X 
R#38 DY7 | DY6 | DY5 | DY4 | DY3 | DY2 | DY1 | DYO DY: Destination 
R#39 0 0 0 0 0 0 DY9 | DY8 transfer point Y 
R#40 NX7 | NX6 | NX5 | NX4 | NX3 | NX2 | NX1 | NXO NX: Number of 
R#41 0 0 0 0 0 0 0 NX8 dots in x-axis 
R#42 NY7 | NY6 | NY5 | NY4 | NY3 | NY2 | NY1 | NYO NY: Number of 
R#43 0 0 0 0 0 0 | NY9 | NY8 dots in Y-axis 
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Step 2: Select destination memory and direction from base coordinate 
MSB 7 6 5 4 3 2 1 0 LSB 
R#45 0 - | MXD | MSX | DIY | DIX - - 


: Right X transfer 
Left direction 


: Down Y transfer 
direction 


VRAM Source 
: ExpRAM | location select 


VRAM Destination 
: ExpRAM | location select 


FO] |r op- Oo]; |F Oo 
Cc 
O 


Step 3: Define logical operation and execute the command 


MSB 7 6 5 4 3 2 1 0 LSB 
R#46 1 0 0 1 | LO3 | LO2 | LO1 | LOO LMMM cmd 
Logical operation 


Step 4: Check for command completion 
CPU should check CE bit of status register S#2 to identify if VDP has completed 


execution of the command. When command is being executed, CE bit is set to 1; when 
command is complete, CE bit will be reset to 0. 
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4.4.8. LMMV (Logical move VDP to VRAM) 


LMMV command is used to paint in a specific rectangular area in the VRAM or 
expansion RAM. The units used are dots. 


Video or expansion RAM 


(DX, DY) 


VDP 


LMMV execution order 
Step 1: Set necessary coordinates in command registers 


MSB 7 6 5 4 3 2 1 0 LSB 


R#36 DX7 | DX6 | DX5 | DX4 | DX3 | DX2 | DXi | DXO DX: Destination 
R#37 0 0 0 0 0 0 0 Dx8 X (dots) 

R#38 DY7 | DY6 | DY5 | DY4 | DY3 | DY2 | DY1 | DYO DY: Destination 
R#39 0 0 0 0 0 0 DY9 | DY8 Y (dots) 

R#40 NX7 | NX6 | NX5 | NX4 | NX3 | NX2 | NX1 | NXO NX: Number of 
R#41 0 0 0 0 0 0 0 NX8 dots in X-axis 
R#42 NY7 | NY6 | NY5 | NY4 | NY3 | NY2 | NY1 | NYO NY: Number of 
R#43 0 0 0 0 0 0 NY9 | NY8 dots in Y-axis 


Step 2: Set color register value 


The color code to use when painting an area should be located in color register R#44 
(CLR). Format of color data depends on the graphics mode. 


R#44 - - - - C3 | C2 | C1 | CO G4, G6 


C7 | C6 | C5 | C4 | C3 | C2 | C1 | CO G7 
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Step 3: Select destination memory and direction from base coordinate 


MSB 7 6 5 4 3 2 1 0 LSB 


VRAM Destination 
: ExpRAM | select 


R#45 0 - MXD - DIY | DIX - - 
0: Right X transfer 
1: Left direction 
0: Down Y transfer 
1: Up direction 
0: 
1 


Step 4: Execute the command 


MSB 7 6 5 4 3 2 1 0 LSB 
R#46 1 0 0 0 E z - - LMMV cmd 


Step 5: Check for command completion 
CPU should check CE bit of status register S#2 to identify if VDP has completed 


execution of the command. When command is being executed, CE bit is set to 1; when 
command is complete, CE bit will be reset to 0. 
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4.4.9. LINE 


LINE command is used to draw straight line in VRAM of expansion RAM. The line 
drawn is the hypotenuse of the triangle defined by the “long” and “short” sides. The 
distances are defined from the single starting point. Words “long” and “short” are used to 
identify respective sets of registers to use to define triangle’s sides: long side is defined in 
registers R#40 and R#41 (by 10 bits MJ9...MJO with value in the range 0...1023) and short 
side is defined in registers R#42 and R#43 (by 9 bits MI8...MIO with value in the range 
0...511). The units used are dots. 


Video or expansion RAM 


(DX, DY) 


LI NE execution order 
Step 1: Set necessary coordinates in command registers 


MSB 7 6 5 4 3 2 1 0 LSB 


R#36 DX7 | DX6 | DX5 | DX4 | DX3 | DX2 | DXi | DXO DX: Starting 
R#37 0 0 0 0 0 0 0 DX8 point X 

R#38 DY7 | DY6 | DY5 | DY4 | DY3 | DY2 | DY1 | DYO DY: Starting 
R#39 0 0 0 0 0 0 DY9 | DY8 point Y 

R#40 NX7 | NX6 | NX5 | NX4 | NX3 | NX2 | NX1 | NXO Maj (NX): long 
R#41 0 0 0 0 0 0 0 NX8 side dots num 
R#42 NY7 | NY6 | NY5 | NY4 | NY3 | NY2 | NY1 | NYO Min (NY): short 
R#43 0 0 0 0 0 0 NY9 | NY8 side dots num 
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Step 2: Set color register value 


Color of the resulting line mask is coded in color register R4#44 (CLR). Format of color 
data depends on the graphics mode. 


MSB 7 6 5 4 3 2 1 0 LSB 
R#44 - - - - C3 | C2 | C1 | CO G4, G6 


E a E - - - Ci | CO G5 
C7 | Co | C5 | C4 | C3 | C2 | C1 | CO G7 


Step 3: Select destination memory, direction from base coordinate and orientation 


Bit MAJ of the register R#45 controls which coordinate is defined in registers R#40- 
R#43. If this bit is 0, then long side (NY) defines triangle’s side by X-axis and short side 
(NX) defines triangle’s side by Y-axis; if this bit is 1, then long side (NY) defines triangle’s 
side by Y-axis and short side (NX) defines triangle’s side by X-axis. 


MSB 7 6 5 4 3 2 1 0 LSB 


R#45 0 - |MXD] - DIY | DIX - MAJ 
0: Long X | Long/short 
1: Long Y | axis definition 
0: Right X transfer 
1: Left direction 
0: Down Y transfer 
1: Up direction 
0: VRAM Destination 
1: ExpRAM | location select 


Step 4: Define logical operation and execute the command 


MSB 7 6 5 4 3 2 1 QO LSB 
R#46 0 1 1 1 LO3 | LO2 | LO1 | LOO LINE cmd 
Logical operation 


Step 5: Check for command completion 
CPU should check CE bit of status register S#2 to identify if VDP has completed 


execution of the command. When command is being executed, CE bit is set to 1; when 
command is complete, CE bit will be reset to 0. 
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4.4.10. SRCH 


SRCH command is used to search for the specific color in VRAM of expansion RAM to 
the right or left of the starting point. The units used are dots. 


Video or expansion RAM 


(SX, SY) 
E 


Border color point 


SRCH execution order 
Step 1: Set necessary coordinates in command registers 


MSB 7 6 5 4 3 2 1 O LSB 


R#32 SX7_| SX6 | SX5 | SX4 | SX3 | SX2 | SXi | SXO SX: Starting 
R#33 0 0 0 0 0 0 0 | SX8 point X 
R#34 SY7 | SY6 | SY5 | SY4 | SY3 | SY2 | SY1 | SYO SY: Starting 
R#35 0 0 0 0 0 0 | SY9 | SY8 point Y 


Step 2: Set color register value 


Color to search for should be coded in color register R#44 (CLR). Format of color data 
depends on the graphics mode. 


MSB 7 6 5 4 3 2 1 0 LSB 
R#44 - 5 E a C3 | C2 | C1 | CO G4, G6 
5 z : Ci | CO G5 
C7 | C6 EB | C4 | C3 | C2 | C1 | CO G7 


Step 3: Select destination memory, direction from base coordinate and orientation 


Bit EQ of the register R#45 controls search stop condition. If it is set to 1, then SRCH 
command terminates when color, equal to R#44 coded color, is found; if it is set to 0, then 
SRCH command terminates when any other than R#44 coded color is found. 
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MSB 7 6 5 4 3 2 1 0 LSB 


R#45 0 - |MXD| - DIX | EQ - 
0: NeqStop | Stop condition 
1: EqStop 
0: Right X search 
1: Left direction 
0: VRAM Destination 
1: ExpRAM | location select 


Step 4: Execute the command 


MSB 7 6 5 4 3 2 1 O LSB 
R#46 0 1 1 0 - - - - SRCH cmd 


Step 5: Check for command termination or completion, and X-coordinate 


Flag BD of the status register S#2 is set if coded color in register R#44 was found, 
otherwise this bit is reset. Current value of the X-coordinate can be read from the status 
registers S#8 and S#9. 


MSB 7 6 5 4 3 2 1 0 LSB 
S#2 = - BD z = = CE 


Set to 0 at the end or termination 
of the command 


Set to 1 if coded color is 
found 


MSB 7 6 5 4 3 2 1 0 LSB 
S#8 BX7 | BX6 | BX5 | BX4 | BX3 | BX2 | BX1 | BXO Current X- 
S#9 1 1 1 1 1 1 1 BX8 coordinate 
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Flowchart of SRCH execution from CPU point of view 


SRCH Start 
Set up VDP registers 


Read status register #2 
Neer: 


end? 


Yes (CE=0) 


No (BD=0) 


Yes (CE=0) 


Read status registers S#8 and S#9 
SRCH End 
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4.4.11. PSET 

PSET command is used to draw a dot in VRAM of expansion RAM. Programmer can 
select logical operation on the existing color of the dot in the specified location. The units 
used are dots. 


Video or expansion RAM 


(DX, DY) 
| 


PSET execution order 
Step 1: Set necessary coordinates in command registers 


MSB 7 6 5 4 3 2 1 0 LSB 


R#36 DX7 | DX6 | DX5 | DX4 | DX3 | DX2 | DX1 | DXO DX: Target 
R#37 0 0 0 0 0 0 0 | DX8 point X 
R#38 DY7 | DY6 | DY5 | DY4 | DY3 | DY2 | DY1 | DYO DY: Target 
R#39 0 0 0 0 0 0 | DY9 | DY8 point Y 


Step 2: Set color register value 


Color of the dot should be coded in color register R#44 (CLR). Format of color data 
depends on the graphics mode. It is possible to do logical operation on the existing and 
new color of the defined dot through coding the code of logical operation in the CMR. 


MSB 7 6 5 4 3 2 1 0 LSB 
R#44 z 3 - - C3 | C2 | C1 | CO G4, G6 


= E E $ E = Ci | CO G5 
C7 | C6 | C5 | C4 | C3 | C2 | C1 | CO G7 
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Step 3: Select destination memory 


MSB 7 6 5 4 3 2 1 0 LSB 
R#45 0 - |MXD| - E 5 E - 


0: VRAM Destination 
1: ExpRAM | location select 


Step 4: Define logical operation and execute the command 


MSB 7 6 5 4 3 2 1 0 LSB 
R#46 0 1 1 0 | LO3 | LO2 | LO1 | LOO PSET cmd 
Logical operation 


Step 5: Check for command completion 
CPU should check CE bit of status register S#2 to identify if VDP has completed 


execution of the command. When command is being executed, CE bit is set to 1; when 
command is complete, CE bit will be reset to 0. 
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4.4.12. POINT 


POINT command is used to read the color of the specified dot located in VRAM of 
expansion RAM. The units used are dots. 


Video or expansion RAM 


(SX, SY) 
E 


POI NT execution order 
Step 1: Set necessary coordinates in command registers 


MSB 7 6 5 4 3 2 1 O LSB 


R#32 SX7_| SX6 | SX5 | SX4 | SX3 | SX2 | SXi | SXO SX: Source 
R#33 0 0 0 0 0 0 0 | SX8 point X 
R#34 SY7 | SY6 | SY5 | SY4 | SY3 | SY2 | SY1 | SYO SY: Source 
R#35 0 0 0 0 0 0 | SY9 | SY8 point Y 


Step 2: Select destination memory 


MSB 7 6 5 4 3 2 1 0 LSB 
R#45 0 - - - |MXS| - - - ARG 


0: VRAM Destination 
1: ExpRAM | location select 


Step 3: Execute the command 


MSB 7 6 5 4 3 2 1 0 LSB 
R#46 0 1 0 0 - - a POINT cmd 
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Step 4: Check for command completion 


CPU should check CE bit of status register S#2 to identify if VDP has completed 
execution of the command. When command is being executed, CE bit is set to 1; when 
command is complete, CE bit will be reset to 0. After completion of the command, source 
dot color code can be read from status register S#7. Note that format of the data in 
various graphics mode differs. 


MSB 7 6 5 4 3 2 1 0 LSB 
S#7 z - = = C3 | C2 | C1 | CO G4, G6 


E E E - - E Ci | CO G5 
C7 | Co | C5 | C4 | C3 | C2 | C1 | CO G7 


4.5. Speeding up the processing of VDP commands 


Programmer can use two methods to speed up VDP hardware acceleration commands. 
Use of both methods is related to decreasing VDP access to the VRAM and freeing 
available VRAM time slots for command execution. 


e Disabling sprites: setting register R#8 bit SPD to 1 disables sprite processing 


e Disabling screen display: setting register R#1 bit BL to 0 will completely disable 
screen display freeing significant memory access time for command execution 
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4.6. States of the registers after command execution 


Setting up VDP registers for command execution is a significant task for programmer 
and CPU, and it will be wise to use already existing values in the registers for the next 
command execution or for further work with video memory. For this purpose programmer 
should know the resulting states of most important VDP registers. Please see the table 
below. Note that if program is going to use sequence of the VDP commands which use 
resulting values of registers from previous commands, it is important to disable interrupts 
so that interrupt handler routing would not accidentally change values in VDP registers and 
thus break the whole command sequence. 

CMR H is a higher nibble of the command register R#46; CMR L is a lower nibble of 
the command register r#46. ARG is an argument register R#45. 

The resulting values of SY*, DY* and NY* are in dots and can be calculated using 
equations below: 

e If DIY=0 then SY*=SY+N; DY*=DY+N 

e If DIY=1 then SY*=SY-N; DY*=DY-N 

e NY*=NY-N 

LINE command = if MAJ=0 then N=N-1 ???? 


SX SY DX DY NX NY CLR è |CMR | CMRL | ARG 

H 
HMMC | - i - 7 i # : 0 i s 
YMMM |- i z ¥ A # = 0 - = 
HMMM | - * : * i # z 0 i ; 
HMMV |- - - i - # 5 0 - - 
LMMC |- : = j i # = 0 : - 
LMCM |- * - i # 5 0 - i 
LMMM |- ‘i A $ é # = 0 = - 
LMMV |- a i = # 0 - i 
LINE |- - - $ - - - 0 - - 
SRCH |- : : = S 5 < 0 : : 
PSET |- - - = : - z 0 i i 
POINT |- : = : = - $ 0 = 
Legend: - Unchanged 


* Coordinate at the command end (SY*, DY*) or color code 
# Count (NY*) when the end of the screen was detected 
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5. SPRITES 


MSX-VIDEO can display up to 32 sprites on the screen. Depending on the sprite mode, 
sprite sizes can be 8*8 or 16*16 dots. X-axis coordinate of sprite location is always 
between 0...255, and this means that in graphics modes with 512 dots on the X-axis single 
sprite’s dot occupy two horizontal dots of the screen. 

Sprites can be placed anywhere on the screen. Sprites are processed independently of 
and do not affect other graphics. They can be independently switched on or off. 

The following diagram conceptually shows how sprites are displayed. Note that visible 
screen area may have 192 or 212 pixels depending on the setting of LN bit of register R#9, 
and visible screen area can be vertically scrolled using vertical offset register R#23. 


(0, 255") (255, 255*) | 


(255,191) or 


(0, 191) or isible 
Invisible screen area | (255, 211) 


(0, 211) 


(0, 254) (255, 254) 
* They Y-coordinate of the upper edge of the sprite screen is 255 


The MSX-VIDEO can work in two sprite display modes. Respective mode is selected 
during initialization of the screen mode. 

e Sprite mode 1: GRAPHIC1, GRAPHIC2, MULTICOLOR 

e Sprite mode 2: GRAPHIC3 ... GRAPHIC7 

Sprites are not available in TEXT1 and TEXT2 modes. 
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5.1. SPRITE MODE 1 (G1, G2, MC) 


While there’s a room for 256 sprite patterns in sprite pattern generator table, VDP is 
only capable of displaying 32 sprites (#0...4#31) — limiting factor is sprite attribute table 
which can hold attributes for 32 active sprites only. 

Up to 4 sprites can be displayed on a single horizontal line, and from the set of 
displayed sprites on this line, the sprites with higher priority will be displayed, and the 
overlapping portions of lower priority sprites will not be displayed. Lower sprite numbers 
are assigned higher priority, with #0 is of highest priority and #31 is of lowest priority. 


When two sprites collide (their pattern color 1 portions have overlapped), status 
register’s S#0 bit 5 “C” is set to 1. 

If there’re more than 4 sprites on the single horizontal line, bit 6 of the status register 
S#0 “5S” is set to 1, and the lower order 5 bits of this status register S#0 will contain the 
number of the fifth sprite. 
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5.1.1. Global sprite attributes and tables (SM1) 


Register R#1 contains two controls for sprites, allowing magnification and quadruple 
sprite pattern size. 


MSB 7 6 5 4 3 2 1 0 LSB 
R#1 0 BL | IEO | Mi | M2 0 SI | MAG Mode R#1 


0: Normal | Sprite 

1: Double | magnification 
0: 8*8 Sprite size 
1:16*16 


Sprites are defined by two tables: sprite pattern generator table, which controls the 
appearance of the dots within the sprite (being on “1” or off “O”) and sprite attribute table, 
which controls positioning, used pattern number and the sprite color. 


5.1.2. Sprite attribute table (SM1) 


The sprite attribute table is an area in the VRAM that defines display coordinates for 
all the possible 32 sprites, their colors, pattern numbers used for display and some other 
flags. Each sprite has four bytes of attribute data, making up 128 bytes (80h) of the 
memory. 


MSB 7 6 5 4 3 2 1 0 LSB 
(B) 0 Y-coordinate (0...255) 
1 X-coordinate (0...255) Attribute area 
2 Pattern number (0...255) for sprite #0 
3| EC - - - Color code 
124 Y-coordinate (0...255) 
125 X-coordinate (0...255) Attribute area 
126 Pattern number (0...255) for sprite #31 
127| EC - - - Color code 


Y-coordinate defines the vertical position of the sprite. Note that if Y is equal to 208 
(DOh), all lower priority sprites will not be displayed. It is important to know that when 
using vertical offset register R#23 to scroll the visible area of the screen, sprite with the Y- 
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coordinate of 208 will not be displayed and in order to display sprite in this area on the 
scrolled screen programmer should use Y-coordinate equal to 207 or 209. 

Pattern number specifies which pattern from sprite pattern generator table to use to 
display the sprite bitmap image. If 8*8 dots sprite size is selected, there’re 256 patterns 
available, but if 16*16 dots sprite size is selected, there there’re only 64 patterns available. 
In 16*16 mode two lower-order bits of the pattern number are not used (and they can 
hold any value). 

Color code specifies color for pattern color 1 (of the dots which are set to “1” in the 
sprite bitmap image). The dots which are set to “0” in the sprite bitmap image will appear 
transparent. 

EC (Early clock) is used to offset sprite by 32 dots to the left. This feature is useful 
when programmer needs to put sprite to the left off the screen. 


5.1.3. Sprite pattern generator table (SM1) 


Sprite pattern generator table is an area in the VRAM specifying the sprite patterns 
(appearance). Base address of this table should be set in register R#6. 

Eight bytes are used for each pattern, and whole table occupies 2048 bytes (800h) 
for all the 256 patterns possible. Each pattern is assigned the number, #0 to #255. If 
sprite size of 8*8 is selected (SI=0) then each displayed sprite has one pattern; if sprite 
size of 16*16 is selected (SI=1) then each sprite is comprised of four patterns. 


MSB 7 6 5 4 3 2 1 0 LSB 
(B) 0 
1 


Bitmap for 
pattern #0 


NOD U1 BR WN 


2040 
2041 
2042 
2043 Bitmap for 
2044 pattern #255 
2045 
2046 
2047 
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5.1.4. Example of the sprite pattern generator table 


8*8 sprite representation 16*16 sprite representation 
MSB LSB 
Offset |7/6/5/4|3|]2|1/0 7/615/4/3]2/1{0/7|6/5/4|3/2|1/0 
0 
1 
2 S 
3 g 
a £ 
5 & 
6 
7 
8 
9 
10 vn 
11 = 
12 £ 
13 & 
14 
15 
16*16 sprite size mode pattern layout 
N 
+ 
Cc 
5 #0 #2 
E 
© 
a 
#1 #3 
24 
25 
26 N Remember that in 16*16 sprite size 
27 c mode two least significant bits of pattern 
28 £ number are not used, and setting sprite 
29 a pattern number 3 will display the same 
30 sprite image as setting sprite pattern 
31 numbers 0, 1 and 2 
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5.2. SPRITE MODE 2 (G3... G7) 


While there’s a room for 256 sprite patterns in sprite pattern generator table, VDP is 
only capable of displaying 32 sprites (#0...4#31) — limiting factor is sprite attribute table 
which can hold attributes for 32 active sprites only. 

Up to 8 sprites can be displayed on a single horizontal line, and from the set of 
displayed sprites on this line, the sprites with higher priority will be displayed, and the 
overlapping portions of lower priority sprites will not be displayed. Lower sprite numbers 
are assigned higher priority, with #0 is of highest priority and #31 is of lowest priority. 


5 
iis [#8] 


When two sprites collide (their solid “1” portions have overlapped), status register’s 
S#0 bit 5 “C” is set to 1, and the coordinates of the collision can be read from status 
registers S#3 ... S#5. 

If there’re more than 8 sprites on the single horizontal line, bit 6 of the status register 
S#0 “5S” is set to 1, and the lower order 5 bits of this status register S#0 will contain the 
number of the ninth sprite. 

The colors of the sprite are specified for each horizontal line. 

The sprite priority may be cancelled by setting bit “CC” in the attribute table for 
specific line of the sprite, and if sprites overlap, logical “OR” will be done on the colors of 
the sprites. Therefore, while in sprite mode 1 sprites may only have two colors (color code 
1 and transparent), in sprite mode 2 four colors may be displayed. 
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5.2.1. Global sprite attributes and tables (SM2) 


Register R#1 contains two controls for sprites, allowing magnification and quadruple 
sprite pattern size. Register R#8 contains one control bit, “SPD”, which allows disabling 
and enabling sprite display. 


MSB 7 6 5 4 3 2 1 0 LSB 
R#1 0 BL | IEO | Mi | M2 0 SI | MAG R#1 


0: Normal | Sprite 
1: Double | magnification 


0: 8*8 Sprite size 
1:16*16 
R#8 MS LP TP CB VR 0 SPD | BW R#8 


0: Enable | Sprite display 
| 1:Disable | control 


Sprites are defined by three tables: sprite pattern generator table, which controls the 
appearance of the dots within the sprite (being on “1” or off “O”), sprite color table, which 
control colors of the sprite lines and other attributes, and sprite attribute table, which 
controls positioning and used pattern number. 


5.2.2. Sprite attribute table (SM2) 
The sprite attribute table is an area in the VRAM that defines display coordinates for 


all the possible 32 sprites, pattern numbers used for display and some other flags. Each 
sprite has four bytes of attribute data, making up 128 bytes (80h) of the memory. 


MSB 7 6 5 4 3 2 1 0 LSB 
(B) 0 Y-coordinate (0...255) 
1 X-coordinate (0...255) Attribute area 
2 Pattern number (0...255) for sprite #0 
3 | Reserved 
124 Y-coordinate (0...255) 
125 X-coordinate (0...255) Attribute area 
126 Pattern number (0...255) for sprite #31 
127 Reserved 
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Y-coordinate defines the vertical position of the sprite. Note that if Y is equal to 216 
(D8h), all lower priority sprites will not be displayed. It is important to know that when 
using vertical offset register R#23 to scroll the visible area of the screen, sprite with the Y- 
coordinate of 216 will not be displayed and in order to display sprite in this area on the 
scrolled screen programmer should use Y=coordinate equal to 215 or 217. 

Pattern number specifies which pattern from sprite pattern generator table to use to 
display the sprite bitmap image. If 8*8 dots sprite size is selected, there’re 256 patterns 
available, but if 16*16 dots sprite size is selected, there there’re only 64 patterns available. 
In 16*16 mode two lower-order bits of the pattern number are not used (and they can 
hold any value). 

Color code is not used in sprite mode 2, and the respective area in the table is 
reserved. 


MSB 7 6 5 4 3 2 1 0 LSB 


R#5 A14 | A13 | A12 | A11 | A10 | 1 X X Sprite attribute 
table low (SM2) 

R#11 0 0 0 0 0 O | A16 | A15 Sprite attribute 
table high 
(SM2) 


5.2.3. Sprite pattern generator table (SM2) 


Sprite pattern generator table is an area in the VRAM specifying the sprite patterns 
(appearance). Base address of this table should be set in register R#6. 

Sprite pattern generator table is designed the same way as in SPRITE MODE 1 (SM1); 
please refer to respective section for the example. Eight bytes are used for each pattern, 
and whole table occupies 2048 bytes (800h) for all the 256 patterns possible. Each pattern 
is assigned the number, #0 to #255. If sprite size of 8*8 is selected (SI=0) then each 
displayed sprite has one pattern; if sprite size of 16*16 is selected (SI=1) then each sprite 
is comprised of four patterns. 
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MSB 7 6 5 4 3 2 1 0 LSB 
(B) 0 


Bitmap for 
pattern #0 


NOOO BWN 


2040 
2041 
2042 
2043 Bitmap for 
2044 pattern #255 
2045 
2046 
2047 


5.2.4. Sprite color table (SM2) 


In SPRITE MODE 2 (SM2) the sprite color table specifies sprite colors for each sprite 
line. Note that sprite color 0 (i.e. the dots having “0” for them in sprite pattern generator 
table) is transparent unless TP bit of register R#8 is set. Each entry also defines sprite 
priority, collision detection, and early clock sprite display options. 

The base address of the sprite color table is calculated using base address of the 
sprite attribute table: sprite color table is located “strictly above” the sprite attribute table, 
having base address of sprite attribute table minus 512 (200h). 

Every sprite is assigned 16 color entries in the sprite color table. If 8*8 sprite size 
mode is selected, only first 8 color bytes are used for every sprite, with another 8 being 
not used. If 16*16 sprite size mode is selected, then all 16 color bytes are used. 
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MSB 7 6 5 4 3 2 1 0 LSB 


0; EC CC IC 0 Color code Line 1 
1 | EC CC IC 0 Color code Line 2 
Colors for 
sprite #0 
15 | EC CC IC 0 Color code Line 16 
496 | EC CC IC 0 Color code Line 1 
497 | EC CC IC 0 Color code Line 2 
Colors for 
sprite #31 
511| EC ce | ic] 0 Color code | Line 16 
Color code for 
each line (0...15) 
0: Detect Line collision 
1: No detect detect 
0: Enable Sprite priority 
1: Disable control 
0: No shift Shift left 32 
1: Shift left dots 


5.2.5. Priority mechanism and multicolored sprite combinations (SM2) 


In sprite mode 2 (SM2), if the “CC” bit of the sprite color table entry is set to 1, the 
sprite priority mechanism is cancelled for the specified line. Collision mechanism does not 
work, mixing color codes of the lines of affected sprites using “OR” logical operation. 

This logical color mixing will work for sprite N if its affected line has CC bit set, and 
this line will collide with the line of another sprite which has CC bit reset to “0” and has 
lower number (N-1, N-2, ..., O — i.e. higher priority). 

Moreover, the line of the sprite having CC bit set to “1” will not be displayed at all if 
there will be no lower number sprite with the line with CC bit set to “0” at the same screen 
line. 

Please see below for the example for the sprite combination displayed in seven colors. 
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MSB LSB 


Sprite #N 1 | 0};0 1} 0 Color code 8 
CC = all set to 0 
B = 
l 
I 4 MSB LSB 
Sprite #N+1 i 0/11/00 Color code 4 
l 
l 
l l 
CC = all set to 1 
l 
Sprite #N+2 


MSB LSB 
0 0 1 0 Color code 2 
2 


CC = all set to 1 


r------ 


Resulting images in SM1 and SM2 modes (all sprites are placed at the same X, Y). 


Sprite mode 2: CC flag is used, no collision Sprite mode 1: collision detection 
detection turned on 
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5.2.6. Sprite collision 


If CC bit is set to 0 and two sprites overlap with their color code 1 (the dots of two 
sprites defined by “1” in their bitmap), a sprite collision event occur, and bit 5 (“C”) of 
status register S#0 will be set to “1”. This bit will be reset when S#0 is read. 

When collision occurs and neither mouse flag (MO) nor the light pen flag (LP) of the 
register R#8 are set, status registers S#3 to S#6 will contain coordinates of the collision. 

When status register S#5 is read, all the contents of registers S#3 to S#6 are reset. 
This means that program should read status registers S#3, S#4 and S#6 before reading 
status register S#5. Collision coordinates can be calculated using the following formulas: 

X (S#4, S#3), Y (S#6, S#5) 

XC=X-12 YC=Y-8 
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5.3. Special rules for sprite color settings 


In all graphic modes except GRAPHIC7 mode, sprite display color is determined by 
the values in palette registers. 

In GRAPHIC7 mode sprite colors are fixed and are not related to contents of palette 
registers. Table below show these effective values. 


Color code 
C3 | C2 | C1 | CO | G2 | G1 | GO | R2 | R1 | RO | B2 | B1 | BO 
0 0 0 0 0 0 0 0 0 0 0 0 0 
0 0 0 1 0 0 0 0 0 0 0 1 0 
0 0 1 0 0 0 0 0 1 1 0 0 0 
0 0 1 1 0 0 0 0 1 1 0 1 0 
0 1 0 0 0 1 1 0 0 0 0 0 0 
0 1 0 1 0 1 1 0 0 0 0 1 0 
0 1 1 0 0 1 1 0 1 1 0 0 0 
0 1 1 1 0 1 1 0 1 1 0 1 0 
1 0 0 0 1 0 0 1 1 1 0 1 0 
1 0 0 1 0 0 0 0 0 0 1 1 1 
1 0 1 0 0 0 0 1 1 1 0 0 0 
1 0 1 1 0 0 0 1 1 1 1 1 1 
1 1 0 0 1 1 1 0 0 0 0 0 0 
1 1 0 1 1 1 1 0 0 0 1 1 1 
1 1 1 0 1 1 1 1 1 1 0 0 0 
1 1 1 1 1 1 1 1 1 1 1 1 1 


The state of bit 5 “TP” of register R#8 affects how sprites are displayed, and affects 
color code 0. 


Color code 0 will be treated as transparent and invisible. All the dots 
TP=0 corresponding to “0” bit value in sprite bitmap will be transparent. These 
dots are considered as non-existent and will not cause collision event 

Color code 0 will be the code corresponding to color #0 in the palette 
register. Note that in GRAPHIC7 mode, value of color #0 is predefined and 


TP=1 equal to G=0, R=0 and B=0. If sprites will overlap with the dots 
corresponding to “0” bit value in their sprite bitmap, collision event will be 
generated 
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6. SPECI AL FUNCTIONS 
6.1. Alternate display of two graphic screen pages 


Two graphics screen pages may be alternatively displayed in G4 to G7 modes 
automatically. In G4 and G5 modes, the following pages can be displayed alternatively: 
page 0 and page 1, and page 2 and page3. In G6 and G7 modes, pages 0 and 1 will be 
alternatively displayed. Please refer to chapter 6.2 for description of page concept. 


G4 and G5 modes G6 and G7 modes 
Page 0 — 
Page 0 = 
Page 1 = 
Page 2 — 
Page 1 = 
Page 3 i 


Display time period of between 166 ms and 2053 ms may be specified for each page. 
See section 3.2.6 for information about available time periods. 

e Specify the odd page address in the pattern layout table register R#2 

e Specify ON (even page) and OFF (odd page display) intervals in register R#13 


6.2. Displaying two graphics screens at 60Hz 


Bit 2 “EO” of register R#9 can be used for displaying two graphics screens alternately 
at 60Hz. Set the odd page pattern layout table in register R#2. Then set bit 2 of register 
R#9 to 1. 


6.3. Interlaced display 
This function displays the first and the second fields on the same page: set the bit 3 
“IL” of the register R#9, to 1. To display even page in the first field and odd page in 


second field, set odd page in pattern layout table register R#2, and set both bits 2 “EO” 
and 3 “IL” in register R#9, to 1. 
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